0.1.19
Getting started
API
Post
Utils
Asset
Assets in Byteball can be issued, transferred, and exchanged, and.they behave similarly to the native currency ‘bytes’.
Arguments
- cap
integreroptional Is the total number of coins that can be issued (money supply). If omitted, the number is unlimited. - is_private
booleanrequired Indicates whether the asset is private (such as blackbytes) or publicly traceable (similar to bytes). - is_transferrable
booleanrequired Indicates whether the asset can be freely transferred among arbitrary parties or all transfers should involve the definer address as either sender or recipient. The latter can be useful e.g. for loyalty points that cannot be resold. - auto_destroy
booleanrequiredIndicates whether the asset is destroyed when it is sent to the definer address. - fixed_denominations
booleanrequiredIndicates whether the asset exists as coins (banknotes) of a limited set of denominations, similar to blackbytes. If it istrue, the definition must also include propertydenominations, which is an array of all denominations and the number of coins of that denomination. - denominations
arrayoptional Array of all denominations and the number of coins of that denomination. - issued_by_definer_only
booleanrequired Indicates whether the asset can be issued only by the definer address. Iffalse, anyone can issue the asset, in this casecapmust be unlimited. - cosigned_by_definer
booleanrequired Indicates whether each operation with the asset must be cosigned by the definer address. Useful for regulated assets where the issuer (bank) wants to perform various compliance checks (such as the funds are not arrested by a court order) prior to approving a transaction. - spender_attested
booleanrequired Indicates whether the spender of the asset must be attested by one of approved attestors. Also useful for regulated assets e.g. to limit the access to the asset only to KYC'ed users. Iftrue, the definition must also include the list of approved attestor addresses. - attestors
arrayoptional List of approved attestor addresses - issue_condition
arrayoptional Specify the restrictions when the asset can be issued. It evaluate to a boolean and are coded in the same smart contract language as address definitions. - transfer_condition
arrayoptional Specify the restrictions when the asset can be transferred. It evaluate to a boolean and are coded in the same smart contract language as address definitions.
Returns
Returns the unit hash.
Example
1
const params = {
2
cap: 1000000,
3
is_private: false,
4
is_transferrable: true,
5
auto_destroy: false,
6
fixed_denominations: false,
7
issued_by_definer_only: true,
8
cosigned_by_definer: false,
9
spender_attested: false
10
};
11
12
client.post.asset(params, wif, function(err, result) {
13
if (err) return console.error(err);
14
console.log(result);
15
// -> xamdfH5Uk+alv3le0pEA01qSsfZjycyMsqaqHtycJ1M=
16
});
Copied!
Learn more
Last modified 1yr ago
Copy link