Metadata
Numscript transactions can interact with metadata, both on transactions and accounts.
Accounts metadata
Reading metadata to initialize a variable
Structured account metadata can be injected in Numscript variables during initialization.
In the example below, we inject the monetary value stored under the metadata key "coupon_value"
from the coupon
account:
Metadata injected in variables need to be typed, and its type is directly read from the value of the key type
of the object stored under the metadata key.
Its value is read from the value of the key value
. Here are all the available types:
- Number
- String
- Asset
- Monetary
- Account
- Portion
{
"amount": {
"type": "number",
"value": 1000
}
}
{
"reference": {
"type": "string",
"value": "82HHON80ILP"
}
}
{
"currency": {
"type": "asset",
"value": "USD/2"
}
}
{
"coupon_value": {
"type": "monetary",
"value": {
"amount": 1000,
"asset": "USD/2"
}
}
}
{
"merchant": {
"type": "account",
"value": "platform:merchant"
}
}
{
"commission": {
"type": "portion",
"value": "15.5%"
}
}
Writing account metadata during a transaction
Metadata can be written to an account using the set_account_meta(_account_, "key", _value_)
statement.
The statement takes a string-type key and a value which can be of any type, either as a variable or a literal.
Writing metadata to a transaction
Metadata can be written to a transaction using the set_tx_meta("key", _value_)
statement.
The statement takes a string-type key and a value which can be of any type, either as a variable or a literal.
Wrap-up example
{
"script": {
"vars": {
"order": "orders:186HH78UH",
"fee": {
"amount": 1000,
"asset": "USD/2"
},
"commission": "15.5%",
"reference": "108IUYGI",
}
}
}