WOLFRAM

Wolfram Language & System Documentation Center
Wolfram Language Home Page »

BlockchainTransaction  (for ARK)

[Experimental]
$BlockchainBase = "ARK"

BlockchainTransaction[assoc]

represents an ARK blockchain transaction built from the components in the association assoc.

Details

  • Gives a symbolic representation of an ARK blockchain transaction; it does not submit the transaction, and the transaction is not signed.
  • BlockchainTransaction[…][prop] gives the value of the property prop for the transaction.
  • The following ARK transaction types are supported. The type is specified using the "Type" element of the association assoc:
  • "Transfer"store-of-value and value transfer
    "SecondSignature"add a second signature to an address
    "DelegateRegistration"register an address as a delegate
    "Vote"vote for a delegate
    "IPFS"store IPFS CID on the blockchain
    "DelegateResignation"withdraw delegate status
    "MultiPayment"enables multiple combined payments
    "MultiSignature"multisignature transaction
  • For transactions of type "Transfer", the following elements must be given:
  • "BlockchainBase"blockchain base to use
    "Recipient"destination address
    "Amount"amount of ARKtoshis to be transferred
  • The following additional elements can also be given for type "Transfer":
  • "Type"type of transaction
    "Fee"dynamic fee to be included
    "TransactionCount"current sender's transaction count plus one
    "SenderPublicKey"public key of the sender address
    "VendorField"data field with a maximum size of 255 bytes
  • For transactions of type "SecondSignature", the following elements must be given:
  • "BlockchainBase"blockchain base to use
    "Type"type of transaction
    "SecondPublicKey"secondary public key to assign to address
  • The following additional elements can also be given for type "SecondSignature":
  • "Fee"dynamic fee to be included
    "TransactionCount"current sender's transaction count plus one
    "SenderPublicKey"public key of the sender address
  • For transactions of type "DelegateRegistration", the following elements must be given:
  • "BlockchainBase"blockchain base to use
    "Type"type of transaction
    "Username"username to register
  • The following additional elements can also be given for type "DelegateRegistration":
  • "Fee"dynamic fee to be included
    "TransactionCount"current sender's transaction count plus one
    "SenderPublicKey"public key of the sender address
  • For transactions of type "Vote", the following elements must be given:
  • "BlockchainBase"blockchain base to use
    "Type"type of transaction
    "Delegate"username or public key of a delegate to vote for
  • The following additional elements can also be given for type "Vote":
  • "Fee"dynamic fee to be included
    "TransactionCount"current sender's transaction count plus one
    "SenderPublicKey"public key of the sender address
  • For transactions of type "IPFS", the following elements must be given:
  • "BlockchainBase"blockchain base to use
    "Type"type of transaction
    "CID"CID of the IPFS asset
  • The following additional elements can also be given for type "IPFS":
  • "Fee"dynamic fee to be included
    "TransactionCount"current sender's transaction count plus one
    "SenderPublicKey"public key of the sender address
  • For transactions of type "DelegateResignation", the following elements must be given:
  • "BlockchainBase"blockchain base to use
    "Type"type of transaction
  • The following additional elements can also be given for type "DelegateResignation":
  • "Fee"dynamic fee to be included
    "TransactionCount"current sender's transaction count plus one
    "SenderPublicKey"public key of the sender address
  • For transactions of type "MultiPayment", the following elements must be given:
  • "BlockchainBase"blockchain base to use
    "Type"type of transaction
    "Payments"list of associations for each payment
  • The following additional elements can also be given for type "MultiPayment":
  • "Fee"dynamic fee to be included
    "TransactionCount"current sender's transaction count plus one
    "SenderPublicKey"public key of the sender address
  • Each association in the "Payments" list must have the following entries:
  • "Amount"amount of ARKtoshis to be transferred
    "Recipient"destination address
  • For transactions of type "MultiSignature", the following elements must be given:
  • "BlockchainBase"blockchain base to use
    "Type"type of transaction
    "PublicKeys"list of public keys for all of the participants of this multisignature address
    "MinimumKeys"minimum number of signatures needed to send a transaction with this multisignature address as sender
    "SenderPublicKey"public key of the sender address
  • The following additional elements can also be given for type "MultiSignature":
  • "Fee"dynamic fee to be included
    "TransactionCount"current sender's transaction count plus one
  • If the sender of the transaction is a multisignature address, the "SenderPublicKey" field becomes mandatory when creating the transaction.
  • BlockchainTransaction can represent ARK mainnet (default) and devnet transactions. To specify these networks, use the "BlockchainBase" value inside the required association or the BlockchainBase option.

Examples

open allclose all

Basic Examples  (1)Summary of the most common use cases

Create an ARK transaction object representing a "Transfer" transaction:

In[1]:=1
✖
https://wolfram.com/xid/0f1g7cgck0ozrda0fr3vjmwojug0ywhdyxfqlpj3lu-ia11p1
Out[1]=1

Scope  (16)Survey of the scope of standard use cases

Transfer Transactions  (3)

Create a simple "Transfer" transaction. Since "Fee" is not provided, it will use the blockchain static fee:

In[1]:=1
✖
https://wolfram.com/xid/0f1g7cgck0ozrda0fr3vjmwojug0ywhdyxfqlpj3lu-hyifpc
Out[1]=1

Create a "Transfer" transaction and specify a dynamic fee:

In[1]:=1
✖
https://wolfram.com/xid/0f1g7cgck0ozrda0fr3vjmwojug0ywhdyxfqlpj3lu-gi56a3
Out[1]=1

Create a "Transfer" transaction and specify a dynamic fee and a vendor field:

In[1]:=1
✖
https://wolfram.com/xid/0f1g7cgck0ozrda0fr3vjmwojug0ywhdyxfqlpj3lu-rjp1dm
Out[1]=1

Second Signature Transactions  (1)

Create a pair of asymmetric keys:

In[1]:=1
✖
https://wolfram.com/xid/0f1g7cgck0ozrda0fr3vjmwojug0ywhdyxfqlpj3lu-hvg48n
Out[1]=1

Create a transaction to assign the public key as a second signature to the associated address:

In[2]:=2
✖
https://wolfram.com/xid/0f1g7cgck0ozrda0fr3vjmwojug0ywhdyxfqlpj3lu-gqcop5
Out[2]=2

Delegate Registration Transactions  (2)

Create a transaction to register an address as delegate using static fees:

In[1]:=1
✖
https://wolfram.com/xid/0f1g7cgck0ozrda0fr3vjmwojug0ywhdyxfqlpj3lu-w4kkcm
Out[1]=1

Create a transaction to register an address as delegate using dynamic fees:

In[1]:=1
✖
https://wolfram.com/xid/0f1g7cgck0ozrda0fr3vjmwojug0ywhdyxfqlpj3lu-6z671
Out[1]=1

Vote Transactions  (3)

Upvote  (1)

Get the public key of a delegate:

In[1]:=1
✖
https://wolfram.com/xid/0f1g7cgck0ozrda0fr3vjmwojug0ywhdyxfqlpj3lu-y7b7l4
Out[1]=1

Create a transaction to upvote the delegate:

In[2]:=2
✖
https://wolfram.com/xid/0f1g7cgck0ozrda0fr3vjmwojug0ywhdyxfqlpj3lu-use35b
Out[2]=2

Unvote  (1)

Get the public key of a delegate:

In[1]:=1
✖
https://wolfram.com/xid/0f1g7cgck0ozrda0fr3vjmwojug0ywhdyxfqlpj3lu-d8e3lb
Out[1]=1

Create a transaction to unvote the delegate:

In[2]:=2
✖
https://wolfram.com/xid/0f1g7cgck0ozrda0fr3vjmwojug0ywhdyxfqlpj3lu-vpe6al
Out[2]=2

Username  (1)

Vote for the delegate using their username:

In[1]:=1
✖
https://wolfram.com/xid/0f1g7cgck0ozrda0fr3vjmwojug0ywhdyxfqlpj3lu-dc2jz3
Out[1]=1

IPFS Transactions  (2)

Create a transaction that includes the CID of an IPFS asset using static fees:

In[1]:=1
✖
https://wolfram.com/xid/0f1g7cgck0ozrda0fr3vjmwojug0ywhdyxfqlpj3lu-t598ys
Out[1]=1

Create a transaction that includes the CID of an IPFS asset using dynamic fees:

In[1]:=1
✖
https://wolfram.com/xid/0f1g7cgck0ozrda0fr3vjmwojug0ywhdyxfqlpj3lu-1fobwg
Out[1]=1

Delegate Resignation Transactions  (2)

Create a transaction to resign as a delegate using static fees:

In[1]:=1
✖
https://wolfram.com/xid/0f1g7cgck0ozrda0fr3vjmwojug0ywhdyxfqlpj3lu-q0pocl
Out[1]=1

Create a transaction to resign as a delegate using dynamic fees:

In[1]:=1
✖
https://wolfram.com/xid/0f1g7cgck0ozrda0fr3vjmwojug0ywhdyxfqlpj3lu-7m3fu5
Out[1]=1

Multipayment Transactions  (2)

Create a transaction with multiple payments using static fees:

In[1]:=1
✖
https://wolfram.com/xid/0f1g7cgck0ozrda0fr3vjmwojug0ywhdyxfqlpj3lu-0tzgqc
Out[1]=1

Create a transaction with multiple payments using dynamic fees:

In[1]:=1
✖
https://wolfram.com/xid/0f1g7cgck0ozrda0fr3vjmwojug0ywhdyxfqlpj3lu-nbwj2w
Out[1]=1

Multisignature Transactions  (1)

Create a transaction to register a multisignature address with the public keys of the participants:

In[1]:=1
✖
https://wolfram.com/xid/0f1g7cgck0ozrda0fr3vjmwojug0ywhdyxfqlpj3lu-kbv8s7
Out[1]=1
In[2]:=2
✖
https://wolfram.com/xid/0f1g7cgck0ozrda0fr3vjmwojug0ywhdyxfqlpj3lu-ihmaak
Out[2]=2
In[3]:=3
✖
https://wolfram.com/xid/0f1g7cgck0ozrda0fr3vjmwojug0ywhdyxfqlpj3lu-yb6cxc
Out[3]=3
In[4]:=4
✖
https://wolfram.com/xid/0f1g7cgck0ozrda0fr3vjmwojug0ywhdyxfqlpj3lu-1d7ysw
Out[4]=4
In[6]:=6
✖
https://wolfram.com/xid/0f1g7cgck0ozrda0fr3vjmwojug0ywhdyxfqlpj3lu-uzbasz
Out[6]=6
In[7]:=7
✖
https://wolfram.com/xid/0f1g7cgck0ozrda0fr3vjmwojug0ywhdyxfqlpj3lu-xko1t4
Out[7]=7

The multisignature address that will be registered is:

In[29]:=29
✖
https://wolfram.com/xid/0f1g7cgck0ozrda0fr3vjmwojug0ywhdyxfqlpj3lu-gz31w5
Out[29]=29

Options  (2)Common values & functionality for each option

BlockchainBase  (2)

Devnet  (1)

Create a devnet transaction:

In[1]:=1
✖
https://wolfram.com/xid/0f1g7cgck0ozrda0fr3vjmwojug0ywhdyxfqlpj3lu-mh0fxu
Out[1]=1

Mainnet  (1)

Create a mainnet transaction:

In[1]:=1
✖
https://wolfram.com/xid/0f1g7cgck0ozrda0fr3vjmwojug0ywhdyxfqlpj3lu-og5x6u
Out[1]=1

Applications  (2)Sample problems that can be solved with this function

Create an ARK BlockchainTransaction:

In[1]:=1
✖
https://wolfram.com/xid/0f1g7cgck0ozrda0fr3vjmwojug0ywhdyxfqlpj3lu-08px58
Out[1]=1

Sign the transaction object using a private key object:

In[3]:=3
✖
https://wolfram.com/xid/0f1g7cgck0ozrda0fr3vjmwojug0ywhdyxfqlpj3lu-siyxoo
Out[3]=3

Send the signed transaction to the ARK blockchain:

In[4]:=4
✖
https://wolfram.com/xid/0f1g7cgck0ozrda0fr3vjmwojug0ywhdyxfqlpj3lu-2ujrjv
Out[4]=4

Create an ARK BlockchainTransaction that uses a multisignature address:

In[1]:=1
✖
https://wolfram.com/xid/0f1g7cgck0ozrda0fr3vjmwojug0ywhdyxfqlpj3lu-dqsnqr
Out[1]=1
In[2]:=2
✖
https://wolfram.com/xid/0f1g7cgck0ozrda0fr3vjmwojug0ywhdyxfqlpj3lu-35sbrr
Out[2]=2

Sign the transaction with the minimum amount of required keys:

In[3]:=3
✖
https://wolfram.com/xid/0f1g7cgck0ozrda0fr3vjmwojug0ywhdyxfqlpj3lu-eemnv7
Out[3]=3
In[4]:=4
✖
https://wolfram.com/xid/0f1g7cgck0ozrda0fr3vjmwojug0ywhdyxfqlpj3lu-tusw9j
Out[4]=4

Send the signed transaction to the ARK blockchain:

In[5]:=5
✖
https://wolfram.com/xid/0f1g7cgck0ozrda0fr3vjmwojug0ywhdyxfqlpj3lu-6mchl0
Out[5]=5

Possible Issues  (1)Common pitfalls and unexpected behavior

Incorrect Recipient  (1)

Providing an invalid address will return a $Failed output:

In[1]:=1
✖
https://wolfram.com/xid/0f1g7cgck0ozrda0fr3vjmwojug0ywhdyxfqlpj3lu-6yfa2j
Out[1]=1
Wolfram Research (2019), BlockchainTransaction, Wolfram Language function, https://reference.wolfram.com/language/ref/blockchain/BlockchainTransaction-ARK.html.
✖
Wolfram Research (2019), BlockchainTransaction, Wolfram Language function, https://reference.wolfram.com/language/ref/blockchain/BlockchainTransaction-ARK.html.

Text

Wolfram Research (2019), BlockchainTransaction, Wolfram Language function, https://reference.wolfram.com/language/ref/blockchain/BlockchainTransaction-ARK.html.

✖
Wolfram Research (2019), BlockchainTransaction, Wolfram Language function, https://reference.wolfram.com/language/ref/blockchain/BlockchainTransaction-ARK.html.

CMS

Wolfram Language. 2019. "BlockchainTransaction." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/blockchain/BlockchainTransaction-ARK.html.

✖
Wolfram Language. 2019. "BlockchainTransaction." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/blockchain/BlockchainTransaction-ARK.html.

APA

Wolfram Language. (2019). BlockchainTransaction. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/blockchain/BlockchainTransaction-ARK.html

✖
Wolfram Language. (2019). BlockchainTransaction. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/blockchain/BlockchainTransaction-ARK.html

BibTeX

@misc{reference.wolfram_2025_blockchaintransaction, author="Wolfram Research", title="{BlockchainTransaction}", year="2019", howpublished="\url{https://reference.wolfram.com/language/ref/blockchain/BlockchainTransaction-ARK.html}", note=[Accessed: 30-March-2025 ]}

✖
@misc{reference.wolfram_2025_blockchaintransaction, author="Wolfram Research", title="{BlockchainTransaction}", year="2019", howpublished="\url{https://reference.wolfram.com/language/ref/blockchain/BlockchainTransaction-ARK.html}", note=[Accessed: 30-March-2025 ]}

BibLaTeX

@online{reference.wolfram_2025_blockchaintransaction, organization={Wolfram Research}, title={BlockchainTransaction}, year={2019}, url={https://reference.wolfram.com/language/ref/blockchain/BlockchainTransaction-ARK.html}, note=[Accessed: 30-March-2025 ]}

✖
@online{reference.wolfram_2025_blockchaintransaction, organization={Wolfram Research}, title={BlockchainTransaction}, year={2019}, url={https://reference.wolfram.com/language/ref/blockchain/BlockchainTransaction-ARK.html}, note=[Accessed: 30-March-2025 ]}