BlockchainContractValue (for Tezos)

BlockchainContractValue[caddr]

gets the storage of a Tezos contract with address caddr.

BlockchainContractValue[caddr,annot]

gets the storage value annotated with annot from the storage of a Tezos contract with address caddr.

BlockchainContractValue[caddr,opList]

gets the storage value after applying the list of Michelson pair operations opList to the storage of a Tezos contract with address caddr.

BlockchainContractValue[caddr,assoc]

gets the storage of a Tezos contract with address caddr with the properties defined in Association assoc.

Details

  • Gives information about the storage of a Tezos contract. By default, it targets the state of the latest block.
  • BlockchainContractValue has option BlockchainBase with default value $BlockchainBase.
  • Possible options for BlockchainContractValue include:
  • BlockchainBase "Tezos"the blockchain and network to use
    MaxItems 20the maximum number of big map items to return
  • BlockchainContractValue will return 1000 big map elements at most.
  • BlockchainContractValue[caddr] returns the storage of a Tezos contract with address caddr.
  • BlockchainContractValue[caddr,annot] returns the annotated storage value where annot must be a String expression.
  • BlockchainContractValue[caddr,opList] returns the storage value where opList must be a List containing Left and Right expressions representing Michelson pair operations.
  • If an annotated Michelson pair is returned by BlockchainContractValue, it returns a nested list of associations with the following properties:
  • "Annotation"annotation of the storage value inside a Michelson pair
    "Value"storage value inside a Michelson pair
  • If there is no storage value associated with annot or opList in the storage of the contract, Missing["NotAvailable"] is returned.
  • BlockchainContractValue[caddr,assoc] returns the storage value with additional parameters where Association assoc can have the following properties:
  • "BlockNumber"block number associated to a specific state of the blockchain
    "Annotation"string used to identify a storage value in a Michelson pair
    "OperationList"list of Left and Right expressions representing Michelson pair operations
    "KeyHash"key hash associated to a Michelson big map element
  • If a Michelson big map is returned by BlockchainContractValue, it returns instead a list of associations with the following properties:
  • "Key"key associated to a Michelson big map element
    "KeyHash"key hash associated to a Michelson big map element
    "Value"value associated to a Michelson big map element
  • When the association assoc in BlockchainContractValue[caddr,assoc] contains the "KeyHash" element, the big map element value corresponding to the specified "KeyHash" is returned.

Examples

open allclose all

Basic Examples  (6)

Get the storage of the USDtz token contract:

Get the total supply of tokens of the USDtz token contract using an annotation:

Get the total supply of tokens of the USDtz token contract using a list of Michelson operation pairs:

Get the total supply of tokens of the USDtz token contract at the block 1000000:

Get the 20 most recently updated balances from the ledger of the USDtz token contract. The annotated storage value "ledger" is a big map, so a list of associations will be returned:

The storage value can also be specified by using a Michelson pair operations list:

Get a specific entry from the ledger of balances of the USDtz token contract:

Options  (3)

BlockchainBase  (2)

Mainnet  (1)

Get the storage of a Tezos contract in mainnet:

Testnet  (1)

Get the storage of a Tezos contract in testnet:

MaxItems  (1)

List the 5 most recently updated big map elements from the "royalties" big map:

Possible Issues  (1)

When referencing a storage value, the "Annotation" and "OperationList" filters cannot be passed together:

Wolfram Research (2020), BlockchainContractValue, Wolfram Language function, https://reference.wolfram.com/language/ref/blockchain/BlockchainContractValue-Tezos.html.

Text

Wolfram Research (2020), BlockchainContractValue, Wolfram Language function, https://reference.wolfram.com/language/ref/blockchain/BlockchainContractValue-Tezos.html.

CMS

Wolfram Language. 2020. "BlockchainContractValue." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/blockchain/BlockchainContractValue-Tezos.html.

APA

Wolfram Language. (2020). BlockchainContractValue. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/blockchain/BlockchainContractValue-Tezos.html

BibTeX

@misc{reference.wolfram_2023_blockchaincontractvalue, author="Wolfram Research", title="{BlockchainContractValue}", year="2020", howpublished="\url{https://reference.wolfram.com/language/ref/blockchain/BlockchainContractValue-Tezos.html}", note=[Accessed: 19-April-2024 ]}

BibLaTeX

@online{reference.wolfram_2023_blockchaincontractvalue, organization={Wolfram Research}, title={BlockchainContractValue}, year={2020}, url={https://reference.wolfram.com/language/ref/blockchain/BlockchainContractValue-Tezos.html}, note=[Accessed: 19-April-2024 ]}