@amadeus-protocol/sdk 1.0.7 → 1.1.0

package/dist/contracts/lockup-prime/types.js

@@ -1,18 +1,17 @@
-/**
- * Type Definitions for LockupPrime smart contract
- *
- * Replaces Zod schemas with plain TypeScript types and type guards.
- */
+//#region src/contracts/lockup-prime/types.ts
 /** Runtime array of all valid tier keys (for validation) */
-export const LOCKUP_PRIME_TIER_KEYS = [
-    '7d',
-    '30d',
-    '90d',
-    '180d',
-    '365d'
+const LOCKUP_PRIME_TIER_KEYS = [
+	"7d",
+	"30d",
+	"90d",
+	"180d",
+	"365d"
 ];
 /** Type guard to check if a string is a valid tier key */
-export function isValidLockupPrimeTierKey(value) {
-    return LOCKUP_PRIME_TIER_KEYS.includes(value);
+function isValidLockupPrimeTierKey(value) {
+	return LOCKUP_PRIME_TIER_KEYS.includes(value);
 }
+//#endregion
+export { LOCKUP_PRIME_TIER_KEYS, isValidLockupPrimeTierKey };
+
 //# sourceMappingURL=types.js.map

package/dist/contracts/lockup-prime/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/contracts/lockup-prime/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,4DAA4D;AAC5D,MAAM,CAAC,MAAM,sBAAsB,GAAkC;IACpE,IAAI;IACJ,KAAK;IACL,KAAK;IACL,MAAM;IACN,MAAM;CACG,CAAA;AAEV,0DAA0D;AAC1D,MAAM,UAAU,yBAAyB,CAAC,KAAa;IACtD,OAAQ,sBAA4C,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;AACrE,CAAC"}
+{"version":3,"file":"types.js","names":[],"sources":["../../../src/contracts/lockup-prime/types.ts"],"sourcesContent":["/**\n * Type Definitions for LockupPrime smart contract\n *\n * Replaces Zod schemas with plain TypeScript types and type guards.\n */\n\n// ── Tier Key Union ──────────────────────────────────────────────────\n\n/** Valid lockup prime tier keys */\nexport type LockupPrimeTierKey = '7d' | '30d' | '90d' | '180d' | '365d'\n\n/** Runtime array of all valid tier keys (for validation) */\nexport const LOCKUP_PRIME_TIER_KEYS: readonly LockupPrimeTierKey[] = [\n\t'7d',\n\t'30d',\n\t'90d',\n\t'180d',\n\t'365d'\n] as const\n\n/** Type guard to check if a string is a valid tier key */\nexport function isValidLockupPrimeTierKey(value: string): value is LockupPrimeTierKey {\n\treturn (LOCKUP_PRIME_TIER_KEYS as readonly string[]).includes(value)\n}\n\n// ── Vault Types ─────────────────────────────────────────────────────\n\n/** Parsed LockupPrime vault */\nexport interface LockupPrimeVault {\n\ttier: LockupPrimeTierKey\n\tmultiplier: number\n\tunlockEpoch: number\n\tlockEpoch: number\n\tamount: number\n\tvaultIndex: number\n}\n\n/** Intermediate parse result from raw vault data string */\nexport interface RawLockupPrimeVaultData {\n\ttier: string\n\tmultiplier: number\n\tunlockEpoch: number\n\tamountFlat: number\n}\n\n/** Extended tier information with UI-specific fields */\nexport interface LockupTier {\n\ttier: string\n\tepochs: number\n\tmultiplier: number\n\tlabel: string\n\tdurationDays: number\n\trate?: number\n}\n\n// ── ABI Types ───────────────────────────────────────────────────────\n\nexport interface LockupPrimeAbiFunction {\n\ttype: 'function'\n\tname: string\n\tinputs: LockupPrimeAbiInput[]\n\toutputs: LockupPrimeAbiOutput[]\n\tstateMutability: 'nonpayable' | 'payable' | 'view' | 'pure'\n\tdescription?: string\n\trequirements?: string[]\n\tstorage?: {\n\t\treads?: LockupPrimeAbiStorageRead[]\n\t\twrites?: LockupPrimeAbiStorageWrite[]\n\t}\n}\n\nexport interface LockupPrimeAbiInput {\n\tname: string\n\ttype: string\n\tdescription?: string\n\tvalidation?: {\n\t\tmin?: string\n\t\tmax?: string\n\t\ttype?: string\n\t}\n\tenum?: string[]\n}\n\nexport interface LockupPrimeAbiOutput {\n\tname: string\n\ttype: string\n\tdescription?: string\n}\n\nexport interface LockupPrimeAbiError {\n\tname: string\n\tcode: string\n\tdescription: string\n}\n\nexport interface LockupPrimeAbiStorage {\n\tkeys: LockupPrimeAbiStorageKey[]\n}\n\nexport interface LockupPrimeAbiStorageKey {\n\tname: string\n\tpattern: string\n\ttype: 'mapping' | 'value' | 'array'\n\tdescription: string\n\tvalueFormat?: string\n\tvalueSchema?: Record<string, any>\n\tquery?: {\n\t\tmethod: string\n\t\tendpoint: string\n\t\tprefix?: string\n\t\tkey?: string\n\t\tdescription: string\n\t}\n}\n\nexport interface LockupPrimeAbiStorageRead {\n\tkey: string\n\tdescription?: string\n\tvalue?: string\n}\n\nexport interface LockupPrimeAbiStorageWrite {\n\tkey: string\n\tvalue?: string\n\toperation?: 'increment' | 'decrement' | 'create' | 'delete' | 'mint'\n\tamount?: string\n\tduration?: string\n\tdescription?: string\n\tcondition?: string\n\twrites?: LockupPrimeAbiStorageWrite[]\n}\n\nexport interface LockupPrimeAbiConstant {\n\ttiers: Record<LockupPrimeTierKey, { epochs: number; multiplier: number; label: string }>\n\tvalues: Record<string, string>\n}\n\n// ── Deprecated Aliases (backward compatibility) ─────────────────────\n\n/** @deprecated Use `LockupPrimeVault` instead */\nexport type LockupPrimeVaultSchema = LockupPrimeVault\n\n/** @deprecated Use `LockupPrimeTierKey` instead */\nexport type LockupTiersSchema = LockupPrimeTierKey\n"],"mappings":";;AAYA,MAAa,yBAAwD;CACpE;CACA;CACA;CACA;CACA;CACA;;AAGD,SAAgB,0BAA0B,OAA4C;CACrF,OAAQ,uBAA6C,SAAS,MAAM"}

package/dist/contracts/nft/abi.d.ts

@@ -0,0 +1,104 @@
+//#region src/contracts/nft/abi.d.ts
+/**
+ * Nft Smart Contract ABI
+ *
+ * Built-in NFT contract.
+ * Source of truth: ex/native/rdb/src/consensus/bic/nft.rs
+ */
+declare const NFT_ABI: {
+  readonly contractName: "Nft";
+  readonly contractVersion: "1.0.0";
+  readonly abi: readonly [{
+    readonly type: "function";
+    readonly name: "transfer";
+    readonly inputs: readonly [{
+      readonly name: "receiver";
+      readonly type: "address";
+      readonly description: "Recipient public key (48-byte raw bytes)";
+    }, {
+      readonly name: "amount";
+      readonly type: "string";
+      readonly description: "Amount of token units to transfer (positive integer as string)";
+    }, {
+      readonly name: "collection";
+      readonly type: "string";
+      readonly description: "Collection name (ASCII alphanumeric, 1-32 chars)";
+    }, {
+      readonly name: "token";
+      readonly type: "string";
+      readonly description: "Token id within the collection (1-32 bytes)";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+    readonly description: "Transfer NFT tokens to another account";
+    readonly requirements: readonly ["receiver must be a valid public key or burn address", "amount must be > 0", "caller must hold at least `amount` tokens of (collection, token)", "collection must not be soulbound"];
+  }, {
+    readonly type: "function";
+    readonly name: "create_collection";
+    readonly inputs: readonly [{
+      readonly name: "collection";
+      readonly type: "string";
+      readonly description: "Collection name (ASCII alphanumeric, 1-32 chars)";
+    }, {
+      readonly name: "soulbound";
+      readonly type: "string";
+      readonly description: "Soulbound flag — \"true\" to disable transfers, otherwise \"false\"";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+    readonly description: "Create a new NFT collection owned by the caller";
+    readonly requirements: readonly ["collection name must be ASCII alphanumeric, 1-32 chars", "collection must not already exist", "collection name must not be reserved"];
+  }, {
+    readonly type: "function";
+    readonly name: "mint";
+    readonly inputs: readonly [{
+      readonly name: "receiver";
+      readonly type: "address";
+      readonly description: "Recipient public key (48-byte raw bytes)";
+    }, {
+      readonly name: "amount";
+      readonly type: "string";
+      readonly description: "Amount of token units to mint (positive integer as string)";
+    }, {
+      readonly name: "collection";
+      readonly type: "string";
+      readonly description: "Collection name";
+    }, {
+      readonly name: "token";
+      readonly type: "string";
+      readonly description: "Token id within the collection (1-32 bytes)";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+    readonly description: "Mint new NFT tokens (only callable by the collection owner)";
+    readonly requirements: readonly ["collection must exist", "caller must be the collection owner (view_account)", "token id must be 1-32 bytes", "amount must be > 0"];
+  }];
+  readonly storage: {
+    readonly keys: readonly [{
+      readonly name: "balance";
+      readonly pattern: "account:{pk}:nft:{collection}:{token}";
+      readonly type: "mapping";
+      readonly description: "Per-token NFT balance for an account";
+      readonly valueFormat: "string";
+      readonly valueSchema: {
+        readonly type: "string";
+        readonly format: "i128";
+        readonly description: "Token balance as integer string";
+      };
+    }, {
+      readonly name: "view_account";
+      readonly pattern: "nft:{collection}:view_account";
+      readonly type: "value";
+      readonly description: "Owner of the collection (raw 48-byte pk)";
+    }, {
+      readonly name: "soulbound";
+      readonly pattern: "nft:{collection}:soulbound";
+      readonly type: "value";
+      readonly description: "Soulbound flag for the collection (\"true\" or absent)";
+    }];
+  };
+  readonly errors: readonly [];
+};
+//#endregion
+export { NFT_ABI };
+//# sourceMappingURL=abi.d.ts.map

package/dist/contracts/nft/abi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abi.d.ts","names":[],"sources":["../../../src/contracts/nft/abi.ts"],"mappings":";;AAMA;;;;;cAAa,OAAA;EAAA"}

package/dist/contracts/nft/abi.js

@@ -0,0 +1,135 @@
+//#region src/contracts/nft/abi.ts
+/**
+* Nft Smart Contract ABI
+*
+* Built-in NFT contract.
+* Source of truth: ex/native/rdb/src/consensus/bic/nft.rs
+*/
+const NFT_ABI = {
+	contractName: "Nft",
+	contractVersion: "1.0.0",
+	abi: [
+		{
+			type: "function",
+			name: "transfer",
+			inputs: [
+				{
+					name: "receiver",
+					type: "address",
+					description: "Recipient public key (48-byte raw bytes)"
+				},
+				{
+					name: "amount",
+					type: "string",
+					description: "Amount of token units to transfer (positive integer as string)"
+				},
+				{
+					name: "collection",
+					type: "string",
+					description: "Collection name (ASCII alphanumeric, 1-32 chars)"
+				},
+				{
+					name: "token",
+					type: "string",
+					description: "Token id within the collection (1-32 bytes)"
+				}
+			],
+			outputs: [],
+			stateMutability: "nonpayable",
+			description: "Transfer NFT tokens to another account",
+			requirements: [
+				"receiver must be a valid public key or burn address",
+				"amount must be > 0",
+				"caller must hold at least `amount` tokens of (collection, token)",
+				"collection must not be soulbound"
+			]
+		},
+		{
+			type: "function",
+			name: "create_collection",
+			inputs: [{
+				name: "collection",
+				type: "string",
+				description: "Collection name (ASCII alphanumeric, 1-32 chars)"
+			}, {
+				name: "soulbound",
+				type: "string",
+				description: "Soulbound flag — \"true\" to disable transfers, otherwise \"false\""
+			}],
+			outputs: [],
+			stateMutability: "nonpayable",
+			description: "Create a new NFT collection owned by the caller",
+			requirements: [
+				"collection name must be ASCII alphanumeric, 1-32 chars",
+				"collection must not already exist",
+				"collection name must not be reserved"
+			]
+		},
+		{
+			type: "function",
+			name: "mint",
+			inputs: [
+				{
+					name: "receiver",
+					type: "address",
+					description: "Recipient public key (48-byte raw bytes)"
+				},
+				{
+					name: "amount",
+					type: "string",
+					description: "Amount of token units to mint (positive integer as string)"
+				},
+				{
+					name: "collection",
+					type: "string",
+					description: "Collection name"
+				},
+				{
+					name: "token",
+					type: "string",
+					description: "Token id within the collection (1-32 bytes)"
+				}
+			],
+			outputs: [],
+			stateMutability: "nonpayable",
+			description: "Mint new NFT tokens (only callable by the collection owner)",
+			requirements: [
+				"collection must exist",
+				"caller must be the collection owner (view_account)",
+				"token id must be 1-32 bytes",
+				"amount must be > 0"
+			]
+		}
+	],
+	storage: { keys: [
+		{
+			name: "balance",
+			pattern: "account:{pk}:nft:{collection}:{token}",
+			type: "mapping",
+			description: "Per-token NFT balance for an account",
+			valueFormat: "string",
+			valueSchema: {
+				type: "string",
+				format: "i128",
+				description: "Token balance as integer string"
+			}
+		},
+		{
+			name: "view_account",
+			pattern: "nft:{collection}:view_account",
+			type: "value",
+			description: "Owner of the collection (raw 48-byte pk)"
+		},
+		{
+			name: "soulbound",
+			pattern: "nft:{collection}:soulbound",
+			type: "value",
+			description: "Soulbound flag for the collection (\"true\" or absent)"
+		}
+	] },
+	errors: []
+};
+//#endregion
+export { NFT_ABI };
+
+//# sourceMappingURL=abi.js.map

package/dist/contracts/nft/abi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abi.js","names":[],"sources":["../../../src/contracts/nft/abi.ts"],"sourcesContent":["/**\n * Nft Smart Contract ABI\n *\n * Built-in NFT contract.\n * Source of truth: ex/native/rdb/src/consensus/bic/nft.rs\n */\nexport const NFT_ABI = {\n\tcontractName: 'Nft',\n\tcontractVersion: '1.0.0',\n\tabi: [\n\t\t{\n\t\t\ttype: 'function',\n\t\t\tname: 'transfer',\n\t\t\tinputs: [\n\t\t\t\t{\n\t\t\t\t\tname: 'receiver',\n\t\t\t\t\ttype: 'address',\n\t\t\t\t\tdescription: 'Recipient public key (48-byte raw bytes)'\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\tname: 'amount',\n\t\t\t\t\ttype: 'string',\n\t\t\t\t\tdescription: 'Amount of token units to transfer (positive integer as string)'\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\tname: 'collection',\n\t\t\t\t\ttype: 'string',\n\t\t\t\t\tdescription: 'Collection name (ASCII alphanumeric, 1-32 chars)'\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\tname: 'token',\n\t\t\t\t\ttype: 'string',\n\t\t\t\t\tdescription: 'Token id within the collection (1-32 bytes)'\n\t\t\t\t}\n\t\t\t],\n\t\t\toutputs: [],\n\t\t\tstateMutability: 'nonpayable',\n\t\t\tdescription: 'Transfer NFT tokens to another account',\n\t\t\trequirements: [\n\t\t\t\t'receiver must be a valid public key or burn address',\n\t\t\t\t'amount must be > 0',\n\t\t\t\t'caller must hold at least `amount` tokens of (collection, token)',\n\t\t\t\t'collection must not be soulbound'\n\t\t\t]\n\t\t},\n\t\t{\n\t\t\ttype: 'function',\n\t\t\tname: 'create_collection',\n\t\t\tinputs: [\n\t\t\t\t{\n\t\t\t\t\tname: 'collection',\n\t\t\t\t\ttype: 'string',\n\t\t\t\t\tdescription: 'Collection name (ASCII alphanumeric, 1-32 chars)'\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\tname: 'soulbound',\n\t\t\t\t\ttype: 'string',\n\t\t\t\t\tdescription: 'Soulbound flag — \"true\" to disable transfers, otherwise \"false\"'\n\t\t\t\t}\n\t\t\t],\n\t\t\toutputs: [],\n\t\t\tstateMutability: 'nonpayable',\n\t\t\tdescription: 'Create a new NFT collection owned by the caller',\n\t\t\trequirements: [\n\t\t\t\t'collection name must be ASCII alphanumeric, 1-32 chars',\n\t\t\t\t'collection must not already exist',\n\t\t\t\t'collection name must not be reserved'\n\t\t\t]\n\t\t},\n\t\t{\n\t\t\ttype: 'function',\n\t\t\tname: 'mint',\n\t\t\tinputs: [\n\t\t\t\t{\n\t\t\t\t\tname: 'receiver',\n\t\t\t\t\ttype: 'address',\n\t\t\t\t\tdescription: 'Recipient public key (48-byte raw bytes)'\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\tname: 'amount',\n\t\t\t\t\ttype: 'string',\n\t\t\t\t\tdescription: 'Amount of token units to mint (positive integer as string)'\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\tname: 'collection',\n\t\t\t\t\ttype: 'string',\n\t\t\t\t\tdescription: 'Collection name'\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\tname: 'token',\n\t\t\t\t\ttype: 'string',\n\t\t\t\t\tdescription: 'Token id within the collection (1-32 bytes)'\n\t\t\t\t}\n\t\t\t],\n\t\t\toutputs: [],\n\t\t\tstateMutability: 'nonpayable',\n\t\t\tdescription: 'Mint new NFT tokens (only callable by the collection owner)',\n\t\t\trequirements: [\n\t\t\t\t'collection must exist',\n\t\t\t\t'caller must be the collection owner (view_account)',\n\t\t\t\t'token id must be 1-32 bytes',\n\t\t\t\t'amount must be > 0'\n\t\t\t]\n\t\t}\n\t],\n\tstorage: {\n\t\tkeys: [\n\t\t\t{\n\t\t\t\tname: 'balance',\n\t\t\t\tpattern: 'account:{pk}:nft:{collection}:{token}',\n\t\t\t\ttype: 'mapping',\n\t\t\t\tdescription: 'Per-token NFT balance for an account',\n\t\t\t\tvalueFormat: 'string',\n\t\t\t\tvalueSchema: {\n\t\t\t\t\ttype: 'string',\n\t\t\t\t\tformat: 'i128',\n\t\t\t\t\tdescription: 'Token balance as integer string'\n\t\t\t\t}\n\t\t\t},\n\t\t\t{\n\t\t\t\tname: 'view_account',\n\t\t\t\tpattern: 'nft:{collection}:view_account',\n\t\t\t\ttype: 'value',\n\t\t\t\tdescription: 'Owner of the collection (raw 48-byte pk)'\n\t\t\t},\n\t\t\t{\n\t\t\t\tname: 'soulbound',\n\t\t\t\tpattern: 'nft:{collection}:soulbound',\n\t\t\t\ttype: 'value',\n\t\t\t\tdescription: 'Soulbound flag for the collection (\"true\" or absent)'\n\t\t\t}\n\t\t]\n\t},\n\terrors: []\n} as const\n"],"mappings":";;;;;;;AAMA,MAAa,UAAU;CACtB,cAAc;CACd,iBAAiB;CACjB,KAAK;EACJ;GACC,MAAM;GACN,MAAM;GACN,QAAQ;IACP;KACC,MAAM;KACN,MAAM;KACN,aAAa;KACb;IACD;KACC,MAAM;KACN,MAAM;KACN,aAAa;KACb;IACD;KACC,MAAM;KACN,MAAM;KACN,aAAa;KACb;IACD;KACC,MAAM;KACN,MAAM;KACN,aAAa;KACb;IACD;GACD,SAAS,EAAE;GACX,iBAAiB;GACjB,aAAa;GACb,cAAc;IACb;IACA;IACA;IACA;IACA;GACD;EACD;GACC,MAAM;GACN,MAAM;GACN,QAAQ,CACP;IACC,MAAM;IACN,MAAM;IACN,aAAa;IACb,EACD;IACC,MAAM;IACN,MAAM;IACN,aAAa;IACb,CACD;GACD,SAAS,EAAE;GACX,iBAAiB;GACjB,aAAa;GACb,cAAc;IACb;IACA;IACA;IACA;GACD;EACD;GACC,MAAM;GACN,MAAM;GACN,QAAQ;IACP;KACC,MAAM;KACN,MAAM;KACN,aAAa;KACb;IACD;KACC,MAAM;KACN,MAAM;KACN,aAAa;KACb;IACD;KACC,MAAM;KACN,MAAM;KACN,aAAa;KACb;IACD;KACC,MAAM;KACN,MAAM;KACN,aAAa;KACb;IACD;GACD,SAAS,EAAE;GACX,iBAAiB;GACjB,aAAa;GACb,cAAc;IACb;IACA;IACA;IACA;IACA;GACD;EACD;CACD,SAAS,EACR,MAAM;EACL;GACC,MAAM;GACN,SAAS;GACT,MAAM;GACN,aAAa;GACb,aAAa;GACb,aAAa;IACZ,MAAM;IACN,QAAQ;IACR,aAAa;IACb;GACD;EACD;GACC,MAAM;GACN,SAAS;GACT,MAAM;GACN,aAAa;GACb;EACD;GACC,MAAM;GACN,SAAS;GACT,MAAM;GACN,aAAa;GACb;EACD,EACD;CACD,QAAQ,EAAE;CACV"}

package/dist/contracts/nft/helpers.d.ts

@@ -0,0 +1,21 @@
+import { ContractCall } from "../contract-call.js";
+import { NftCreateCollectionParams, NftMintParams, NftTransferParams } from "./types.js";
+
+//#region src/contracts/nft/helpers.d.ts
+/**
+ * Build an `Nft.transfer` ContractCall.
+ */
+declare function buildNftTransfer(params: NftTransferParams): ContractCall;
+/**
+ * Build an `Nft.mint` ContractCall.
+ *
+ * Only callable by the collection owner.
+ */
+declare function buildNftMint(params: NftMintParams): ContractCall;
+/**
+ * Build an `Nft.create_collection` ContractCall.
+ */
+declare function buildNftCreateCollection(params: NftCreateCollectionParams): ContractCall;
+//#endregion
+export { buildNftCreateCollection, buildNftMint, buildNftTransfer };
+//# sourceMappingURL=helpers.d.ts.map

package/dist/contracts/nft/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","names":[],"sources":["../../../src/contracts/nft/helpers.ts"],"mappings":";;;;;;;iBAwBgB,gBAAA,CAAiB,MAAA,EAAQ,iBAAA,GAAoB,YAAA;AAkB7D;;;;;AAAA,iBAAgB,YAAA,CAAa,MAAA,EAAQ,aAAA,GAAgB,YAAA;;;;iBAgBrC,wBAAA,CAAyB,MAAA,EAAQ,yBAAA,GAA4B,YAAA"}

package/dist/contracts/nft/helpers.js

@@ -0,0 +1,61 @@
+import { fromBase58 } from "../../encoding.js";
+//#region src/contracts/nft/helpers.ts
+/**
+* Builder helpers for the Nft built-in contract.
+*
+* Each helper returns a `ContractCall` that can be passed to `TransactionBuilder`
+* for signing and submission. NFT amounts are integer counts (not atomic AMA), and
+* `receiver` is decoded from Base58 to raw 48-byte public key bytes.
+*/
+function amountToIntegerString(amount) {
+	if (typeof amount === "bigint") return amount.toString();
+	if (typeof amount === "string") return amount;
+	if (!Number.isFinite(amount) || !Number.isInteger(amount) || amount <= 0) throw new Error(`invalid_amount: ${amount}`);
+	return amount.toString();
+}
+/**
+* Build an `Nft.transfer` ContractCall.
+*/
+function buildNftTransfer(params) {
+	return {
+		contract: "Nft",
+		method: "transfer",
+		args: [
+			fromBase58(params.recipient),
+			amountToIntegerString(params.amount),
+			params.collection,
+			params.token
+		]
+	};
+}
+/**
+* Build an `Nft.mint` ContractCall.
+*
+* Only callable by the collection owner.
+*/
+function buildNftMint(params) {
+	return {
+		contract: "Nft",
+		method: "mint",
+		args: [
+			fromBase58(params.recipient),
+			amountToIntegerString(params.amount),
+			params.collection,
+			params.token
+		]
+	};
+}
+/**
+* Build an `Nft.create_collection` ContractCall.
+*/
+function buildNftCreateCollection(params) {
+	return {
+		contract: "Nft",
+		method: "create_collection",
+		args: [params.collection, params.soulbound ? "true" : "false"]
+	};
+}
+//#endregion
+export { buildNftCreateCollection, buildNftMint, buildNftTransfer };
+
+//# sourceMappingURL=helpers.js.map

package/dist/contracts/nft/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","names":[],"sources":["../../../src/contracts/nft/helpers.ts"],"sourcesContent":["/**\n * Builder helpers for the Nft built-in contract.\n *\n * Each helper returns a `ContractCall` that can be passed to `TransactionBuilder`\n * for signing and submission. NFT amounts are integer counts (not atomic AMA), and\n * `receiver` is decoded from Base58 to raw 48-byte public key bytes.\n */\n\nimport { fromBase58 } from '../../encoding'\nimport type { ContractCall } from '../contract-call'\nimport type { NftTransferParams, NftMintParams, NftCreateCollectionParams } from './types'\n\nfunction amountToIntegerString(amount: number | string | bigint): string {\n\tif (typeof amount === 'bigint') return amount.toString()\n\tif (typeof amount === 'string') return amount\n\tif (!Number.isFinite(amount) || !Number.isInteger(amount) || amount <= 0) {\n\t\tthrow new Error(`invalid_amount: ${amount}`)\n\t}\n\treturn amount.toString()\n}\n\n/**\n * Build an `Nft.transfer` ContractCall.\n */\nexport function buildNftTransfer(params: NftTransferParams): ContractCall {\n\treturn {\n\t\tcontract: 'Nft',\n\t\tmethod: 'transfer',\n\t\targs: [\n\t\t\tfromBase58(params.recipient),\n\t\t\tamountToIntegerString(params.amount),\n\t\t\tparams.collection,\n\t\t\tparams.token\n\t\t]\n\t}\n}\n\n/**\n * Build an `Nft.mint` ContractCall.\n *\n * Only callable by the collection owner.\n */\nexport function buildNftMint(params: NftMintParams): ContractCall {\n\treturn {\n\t\tcontract: 'Nft',\n\t\tmethod: 'mint',\n\t\targs: [\n\t\t\tfromBase58(params.recipient),\n\t\t\tamountToIntegerString(params.amount),\n\t\t\tparams.collection,\n\t\t\tparams.token\n\t\t]\n\t}\n}\n\n/**\n * Build an `Nft.create_collection` ContractCall.\n */\nexport function buildNftCreateCollection(params: NftCreateCollectionParams): ContractCall {\n\treturn {\n\t\tcontract: 'Nft',\n\t\tmethod: 'create_collection',\n\t\targs: [params.collection, params.soulbound ? 'true' : 'false']\n\t}\n}\n"],"mappings":";;;;;;;;;AAYA,SAAS,sBAAsB,QAA0C;CACxE,IAAI,OAAO,WAAW,UAAU,OAAO,OAAO,UAAU;CACxD,IAAI,OAAO,WAAW,UAAU,OAAO;CACvC,IAAI,CAAC,OAAO,SAAS,OAAO,IAAI,CAAC,OAAO,UAAU,OAAO,IAAI,UAAU,GACtE,MAAM,IAAI,MAAM,mBAAmB,SAAS;CAE7C,OAAO,OAAO,UAAU;;;;;AAMzB,SAAgB,iBAAiB,QAAyC;CACzE,OAAO;EACN,UAAU;EACV,QAAQ;EACR,MAAM;GACL,WAAW,OAAO,UAAU;GAC5B,sBAAsB,OAAO,OAAO;GACpC,OAAO;GACP,OAAO;GACP;EACD;;;;;;;AAQF,SAAgB,aAAa,QAAqC;CACjE,OAAO;EACN,UAAU;EACV,QAAQ;EACR,MAAM;GACL,WAAW,OAAO,UAAU;GAC5B,sBAAsB,OAAO,OAAO;GACpC,OAAO;GACP,OAAO;GACP;EACD;;;;;AAMF,SAAgB,yBAAyB,QAAiD;CACzF,OAAO;EACN,UAAU;EACV,QAAQ;EACR,MAAM,CAAC,OAAO,YAAY,OAAO,YAAY,SAAS,QAAQ;EAC9D"}

package/dist/contracts/nft/types.d.ts

@@ -0,0 +1,47 @@
+//#region src/contracts/nft/types.d.ts
+/**
+ * Type definitions for the Nft built-in contract.
+ */
+/** Parameters for `Nft.transfer(receiver, amount, collection, token)` */
+interface NftTransferParams {
+  /** Base58-encoded recipient address */
+  recipient: string;
+  /** Number of token units to transfer */
+  amount: number | string | bigint;
+  /** Collection name */
+  collection: string;
+  /** Token id within the collection */
+  token: string;
+}
+/** Parameters for `Nft.mint(receiver, amount, collection, token)` */
+interface NftMintParams {
+  /** Base58-encoded recipient address */
+  recipient: string;
+  /** Number of token units to mint */
+  amount: number | string | bigint;
+  /** Collection name */
+  collection: string;
+  /** Token id within the collection */
+  token: string;
+}
+/** Parameters for `Nft.create_collection(collection, soulbound)` */
+interface NftCreateCollectionParams {
+  /** Collection name (ASCII alphanumeric, 1-32 chars) */
+  collection: string;
+  /** When true, tokens cannot be transferred after minting */
+  soulbound?: boolean;
+}
+/** Inputs for builder convenience methods that need a private key */
+interface NftTransferInput extends NftTransferParams {
+  /** Base58-encoded sender private key (seed) */
+  senderPrivkey: string;
+}
+interface NftMintInput extends NftMintParams {
+  senderPrivkey: string;
+}
+interface NftCreateCollectionInput extends NftCreateCollectionParams {
+  senderPrivkey: string;
+}
+//#endregion
+export { NftCreateCollectionInput, NftCreateCollectionParams, NftMintInput, NftMintParams, NftTransferInput, NftTransferParams };
+//# sourceMappingURL=types.d.ts.map

package/dist/contracts/nft/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../../src/contracts/nft/types.ts"],"mappings":";;AAKA;;;UAAiB,iBAAA;EAEhB;EAAA,SAAA;EAIA;EAFA,MAAA;EAIK;EAFL,UAAA;EAMgB;EAJhB,KAAA;AAAA;;UAIgB,aAAA;EAIhB;EAFA,SAAA;EAMA;EAJA,MAAA;EAIK;EAFL,UAAA;EAMyC;EAJzC,KAAA;AAAA;;UAIgB,yBAAA;EAQiB;EANjC,UAAA;EAMyC;EAJzC,SAAA;AAAA;;UAIgB,gBAAA,SAAyB,iBAAA;EAKJ;EAHrC,aAAA;AAAA;AAAA,UAGgB,YAAA,SAAqB,aAAA;EACrC,aAAA;AAAA;AAAA,UAGgB,wBAAA,SAAiC,yBAAA;EACjD,aAAA;AAAA"}

package/dist/conversion.d.ts

@@ -1,3 +1,4 @@
+//#region src/conversion.d.ts
 /**
  * Token Conversion Utilities
  *
@@ -16,7 +17,7 @@
  * const ama = fromAtomicAma(1000000000)  // Returns 1.0
  * ```
  */
-export declare function fromAtomicAma(atomicAma: number | string): number;
+declare function fromAtomicAma(atomicAma: number | string): number;
 /**
  * Convert human-readable AMA amount to atomic units
  *
@@ -32,5 +33,7 @@ export declare function fromAtomicAma(atomicAma: number | string): number;
  * const atomic = toAtomicAma('1.00000001')   // Returns 1000000010
  * ```
  */
-export declare function toAtomicAma(ama: number | string): number;
+declare function toAtomicAma(ama: number | string): number;
+//#endregion
+export { fromAtomicAma, toAtomicAma };
 //# sourceMappingURL=conversion.d.ts.map

package/dist/conversion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conversion.d.ts","sourceRoot":"","sources":["../src/conversion.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAgBhE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAIxD"}
+{"version":3,"file":"conversion.d.ts","names":[],"sources":["../src/conversion.ts"],"mappings":";;AAqBA;;;;;AAiCA;;;;;;;;;;;;AAAA,iBAjCgB,aAAA,CAAc,SAAA;;;;;;;;;;;;;;;;iBAiCd,WAAA,CAAY,GAAA"}

package/dist/conversion.js

@@ -1,56 +1,51 @@
+import { AMA_TOKEN_DECIMALS_MULTIPLIER } from "./constants.js";
+//#region src/conversion.ts
 /**
- * Token Conversion Utilities
- *
- * This module provides functions for converting between atomic units
- * and human-readable token amounts for the AMA token.
- */
-import { AMA_TOKEN_DECIMALS, AMA_TOKEN_DECIMALS_MULTIPLIER } from './constants';
+* Token Conversion Utilities
+*
+* This module provides functions for converting between atomic units
+* and human-readable token amounts for the AMA token.
+*/
 /**
- * Convert atomic AMA units to human-readable AMA amount
- *
- * @param atomicAma - Atomic units (as number or string)
- * @returns Human-readable AMA amount
- * @throws Error if the value is invalid
- *
- * @example
- * ```ts
- * const ama = fromAtomicAma(1000000000)  // Returns 1.0
- * ```
- */
-export function fromAtomicAma(atomicAma) {
-    const atomicAmaAmount = typeof atomicAma === 'string' ? parseFloat(atomicAma) : atomicAma;
-    if (isNaN(atomicAmaAmount) || atomicAmaAmount === 0) {
-        return 0;
-    }
-    if (atomicAmaAmount < 0) {
-        throw new Error('Negative value not allowed');
-    }
-    if (atomicAmaAmount < 1) {
-        throw new Error('Value is less than 1');
-    }
-    if (atomicAmaAmount > Number.MAX_SAFE_INTEGER) {
-        throw new Error('Value exceeds maximum safe integer');
-    }
-    return atomicAmaAmount / AMA_TOKEN_DECIMALS_MULTIPLIER;
+* Convert atomic AMA units to human-readable AMA amount
+*
+* @param atomicAma - Atomic units (as number or string)
+* @returns Human-readable AMA amount
+* @throws Error if the value is invalid
+*
+* @example
+* ```ts
+* const ama = fromAtomicAma(1000000000)  // Returns 1.0
+* ```
+*/
+function fromAtomicAma(atomicAma) {
+	const atomicAmaAmount = typeof atomicAma === "string" ? parseFloat(atomicAma) : atomicAma;
+	if (isNaN(atomicAmaAmount) || atomicAmaAmount === 0) return 0;
+	if (atomicAmaAmount < 0) throw new Error("Negative value not allowed");
+	if (atomicAmaAmount < 1) throw new Error("Value is less than 1");
+	if (atomicAmaAmount > Number.MAX_SAFE_INTEGER) throw new Error("Value exceeds maximum safe integer");
+	return atomicAmaAmount / AMA_TOKEN_DECIMALS_MULTIPLIER;
 }
 /**
- * Convert human-readable AMA amount to atomic units
- *
- * Uses string splitting to avoid floating-point precision issues
- * while preserving truncation (never rounds up) for safety.
- *
- * @param ama - Human-readable AMA amount (number or string)
- * @returns Atomic units (integer)
- *
- * @example
- * ```ts
- * const atomic = toAtomicAma(1.5)            // Returns 1500000000
- * const atomic = toAtomicAma('1.00000001')   // Returns 1000000010
- * ```
- */
-export function toAtomicAma(ama) {
-    const num = typeof ama === 'string' ? parseFloat(ama) : ama;
-    const [int, frac = ''] = num.toFixed(AMA_TOKEN_DECIMALS).split('.');
-    return parseInt(int + frac, 10);
+* Convert human-readable AMA amount to atomic units
+*
+* Uses string splitting to avoid floating-point precision issues
+* while preserving truncation (never rounds up) for safety.
+*
+* @param ama - Human-readable AMA amount (number or string)
+* @returns Atomic units (integer)
+*
+* @example
+* ```ts
+* const atomic = toAtomicAma(1.5)            // Returns 1500000000
+* const atomic = toAtomicAma('1.00000001')   // Returns 1000000010
+* ```
+*/
+function toAtomicAma(ama) {
+	const [int, frac = ""] = (typeof ama === "string" ? parseFloat(ama) : ama).toFixed(9).split(".");
+	return parseInt(int + frac, 10);
 }
+//#endregion
+export { fromAtomicAma, toAtomicAma };
+
 //# sourceMappingURL=conversion.js.map

package/dist/conversion.js.map

@@ -1 +1 @@
-{"version":3,"file":"conversion.js","sourceRoot":"","sources":["../src/conversion.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,kBAAkB,EAAE,6BAA6B,EAAE,MAAM,aAAa,CAAA;AAE/E;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAAC,SAA0B;IACvD,MAAM,eAAe,GAAG,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IAEzF,IAAI,KAAK,CAAC,eAAe,CAAC,IAAI,eAAe,KAAK,CAAC,EAAE,CAAC;QACrD,OAAO,CAAC,CAAA;IACT,CAAC;IACD,IAAI,eAAe,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAA;IAC9C,CAAC;IACD,IAAI,eAAe,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAA;IACxC,CAAC;IACD,IAAI,eAAe,GAAG,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAA;IACtD,CAAC;IACD,OAAO,eAAe,GAAG,6BAA6B,CAAA;AACvD,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,WAAW,CAAC,GAAoB;IAC/C,MAAM,GAAG,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAA;IAC3D,MAAM,CAAC,GAAG,EAAE,IAAI,GAAG,EAAE,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IACnE,OAAO,QAAQ,CAAC,GAAG,GAAG,IAAI,EAAE,EAAE,CAAC,CAAA;AAChC,CAAC"}
+{"version":3,"file":"conversion.js","names":[],"sources":["../src/conversion.ts"],"sourcesContent":["/**\n * Token Conversion Utilities\n *\n * This module provides functions for converting between atomic units\n * and human-readable token amounts for the AMA token.\n */\n\nimport { AMA_TOKEN_DECIMALS, AMA_TOKEN_DECIMALS_MULTIPLIER } from './constants'\n\n/**\n * Convert atomic AMA units to human-readable AMA amount\n *\n * @param atomicAma - Atomic units (as number or string)\n * @returns Human-readable AMA amount\n * @throws Error if the value is invalid\n *\n * @example\n * ```ts\n * const ama = fromAtomicAma(1000000000)  // Returns 1.0\n * ```\n */\nexport function fromAtomicAma(atomicAma: number | string): number {\n\tconst atomicAmaAmount = typeof atomicAma === 'string' ? parseFloat(atomicAma) : atomicAma\n\n\tif (isNaN(atomicAmaAmount) || atomicAmaAmount === 0) {\n\t\treturn 0\n\t}\n\tif (atomicAmaAmount < 0) {\n\t\tthrow new Error('Negative value not allowed')\n\t}\n\tif (atomicAmaAmount < 1) {\n\t\tthrow new Error('Value is less than 1')\n\t}\n\tif (atomicAmaAmount > Number.MAX_SAFE_INTEGER) {\n\t\tthrow new Error('Value exceeds maximum safe integer')\n\t}\n\treturn atomicAmaAmount / AMA_TOKEN_DECIMALS_MULTIPLIER\n}\n\n/**\n * Convert human-readable AMA amount to atomic units\n *\n * Uses string splitting to avoid floating-point precision issues\n * while preserving truncation (never rounds up) for safety.\n *\n * @param ama - Human-readable AMA amount (number or string)\n * @returns Atomic units (integer)\n *\n * @example\n * ```ts\n * const atomic = toAtomicAma(1.5)            // Returns 1500000000\n * const atomic = toAtomicAma('1.00000001')   // Returns 1000000010\n * ```\n */\nexport function toAtomicAma(ama: number | string): number {\n\tconst num = typeof ama === 'string' ? parseFloat(ama) : ama\n\tconst [int, frac = ''] = num.toFixed(AMA_TOKEN_DECIMALS).split('.')\n\treturn parseInt(int + frac, 10)\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAqBA,SAAgB,cAAc,WAAoC;CACjE,MAAM,kBAAkB,OAAO,cAAc,WAAW,WAAW,UAAU,GAAG;CAEhF,IAAI,MAAM,gBAAgB,IAAI,oBAAoB,GACjD,OAAO;CAER,IAAI,kBAAkB,GACrB,MAAM,IAAI,MAAM,6BAA6B;CAE9C,IAAI,kBAAkB,GACrB,MAAM,IAAI,MAAM,uBAAuB;CAExC,IAAI,kBAAkB,OAAO,kBAC5B,MAAM,IAAI,MAAM,qCAAqC;CAEtD,OAAO,kBAAkB;;;;;;;;;;;;;;;;;AAkB1B,SAAgB,YAAY,KAA8B;CAEzD,MAAM,CAAC,KAAK,OAAO,OADP,OAAO,QAAQ,WAAW,WAAW,IAAI,GAAG,KAC3B,QAAA,EAA2B,CAAC,MAAM,IAAI;CACnE,OAAO,SAAS,MAAM,MAAM,GAAG"}