@amadeus-protocol/sdk 1.0.5 → 1.0.7

package/dist/contracts/contract.d.ts

@@ -0,0 +1,113 @@
+/**
+ * ABI-Driven Contract Factory
+ *
+ * Generates fully-typed contract interfaces from `as const` ABI definitions,
+ * similar to viem's getContract() or ethers typechain.
+ *
+ * Each function declared in the ABI becomes a typed method on the contract
+ * object — with autocomplete for function names and typed params derived
+ * from the ABI inputs.
+ *
+ * @example
+ * ```ts
+ * import { createContract, LOCKUP_PRIME_ABI, toAtomicAma } from '@amadeus-protocol/sdk'
+ *
+ * // Unsigned — returns ContractCall for TransactionBuilder.signCall()
+ * const lockupPrime = createContract(LOCKUP_PRIME_ABI)
+ * const call = lockupPrime.lock({ amount: toAtomicAma(100).toString(), tier: '30d' })
+ * const { txHash, txPacked } = TransactionBuilder.signCall(privateKey, call)
+ *
+ * // Signed — bind a private key, methods return BuildTransactionResult directly
+ * const signed = createContract(LOCKUP_PRIME_ABI).connect(privateKey)
+ * const result = signed.lock({ amount: toAtomicAma(100).toString(), tier: '30d' })
+ * ```
+ */
+import type { BuildTransactionResult } from '../types';
+import type { AbiDefinition, AbiInput } from './abi-types';
+import type { ContractCall } from './contract-call';
+/**
+ * Map an ABI inputs tuple to a params object: `{ inputName: string }`
+ */
+type InputsToParams<Inputs extends readonly AbiInput[]> = {
+    readonly [I in Inputs[number] as I['name']]: string;
+};
+/**
+ * For each function in the ABI, generate a typed method signature.
+ *
+ * - Functions with inputs → `(params: { name: string, ... }) => ContractCall`
+ * - Functions without inputs → `() => ContractCall`
+ */
+type ContractMethods<TAbi extends AbiDefinition> = {
+    readonly [F in TAbi['abi'][number] as F['name']]: F['inputs'] extends readonly [] ? () => ContractCall : (params: InputsToParams<F['inputs']>) => ContractCall;
+};
+/**
+ * Same as ContractMethods but methods return signed `BuildTransactionResult`.
+ */
+type SignedContractMethods<TAbi extends AbiDefinition> = {
+    readonly [F in TAbi['abi'][number] as F['name']]: F['inputs'] extends readonly [] ? () => BuildTransactionResult : (params: InputsToParams<F['inputs']>) => BuildTransactionResult;
+};
+/**
+ * A typed contract interface generated from an ABI definition.
+ *
+ * Each ABI function is exposed as a method that returns a `ContractCall`
+ * (ready for `TransactionBuilder.signCall()`).
+ *
+ * Call `.connect(privateKey)` to get a `SignedContract` where methods
+ * return `BuildTransactionResult` directly.
+ */
+export type TypedContract<TAbi extends AbiDefinition> = ContractMethods<TAbi> & {
+    /** The original ABI definition */
+    readonly abi: TAbi;
+    /** Contract name extracted from ABI */
+    readonly contractName: TAbi['contractName'];
+    /**
+     * Bind a signer to produce a `SignedContract` where every method
+     * derives keys, builds, and signs in one step.
+     *
+     * @param privateKey - Base58 encoded private key (seed)
+     */
+    connect(privateKey: string): SignedContract<TAbi>;
+};
+/**
+ * A signer-bound contract interface.
+ *
+ * Every ABI function is a method that returns `BuildTransactionResult`
+ * (txHash + txPacked ready for submission).
+ */
+export type SignedContract<TAbi extends AbiDefinition> = SignedContractMethods<TAbi> & {
+    /** The original ABI definition */
+    readonly abi: TAbi;
+    /** Contract name extracted from ABI */
+    readonly contractName: TAbi['contractName'];
+};
+/**
+ * Create a typed contract interface from an ABI definition.
+ *
+ * Returns an object where each ABI function is a method with fully typed
+ * params (derived from ABI inputs) and autocomplete on function names.
+ *
+ * @param abi - An ABI definition object (must be declared `as const`)
+ * @returns A typed `TypedContract<TAbi>` with methods for each ABI function
+ *
+ * @example
+ * ```ts
+ * import { createContract, LOCKUP_PRIME_ABI, LOCKUP_ABI, toAtomicAma } from '@amadeus-protocol/sdk'
+ *
+ * // Each ABI function becomes a typed method:
+ * const lockupPrime = createContract(LOCKUP_PRIME_ABI)
+ * lockupPrime.lock({ amount: toAtomicAma(100).toString(), tier: '30d' })   // typed
+ * lockupPrime.unlock({ vaultIndex: '3' })                                   // typed
+ * lockupPrime.daily_checkin({ vaultIndex: '7' })                            // typed
+ *
+ * // Sign the call:
+ * const call = lockupPrime.lock({ amount: '100000000000', tier: '30d' })
+ * const { txHash, txPacked } = TransactionBuilder.signCall(privateKey, call)
+ *
+ * // Or bind a signer:
+ * const signed = lockupPrime.connect(privateKey)
+ * const result = signed.lock({ amount: '100000000000', tier: '30d' })
+ * ```
+ */
+export declare function createContract<TAbi extends AbiDefinition>(abi: TAbi): TypedContract<TAbi>;
+export {};
+//# sourceMappingURL=contract.d.ts.map

package/dist/contracts/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/contracts/contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAA;AAEtD,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAKnD;;GAEG;AACH,KAAK,cAAc,CAAC,MAAM,SAAS,SAAS,QAAQ,EAAE,IAAI;IACzD,QAAQ,EAAE,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,GAAG,MAAM;CACnD,CAAA;AAED;;;;;GAKG;AACH,KAAK,eAAe,CAAC,IAAI,SAAS,aAAa,IAAI;IAClD,QAAQ,EAAE,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,SAAS,SAAS,EAAE,GAC9E,MAAM,YAAY,GAClB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,KAAK,YAAY;CACxD,CAAA;AAED;;GAEG;AACH,KAAK,qBAAqB,CAAC,IAAI,SAAS,aAAa,IAAI;IACxD,QAAQ,EAAE,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,SAAS,SAAS,EAAE,GAC9E,MAAM,sBAAsB,GAC5B,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,KAAK,sBAAsB;CAClE,CAAA;AAID;;;;;;;;GAQG;AACH,MAAM,MAAM,aAAa,CAAC,IAAI,SAAS,aAAa,IAAI,eAAe,CAAC,IAAI,CAAC,GAAG;IAC/E,kCAAkC;IAClC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAA;IAClB,uCAAuC;IACvC,QAAQ,CAAC,YAAY,EAAE,IAAI,CAAC,cAAc,CAAC,CAAA;IAC3C;;;;;OAKG;IACH,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,CAAA;CACjD,CAAA;AAED;;;;;GAKG;AACH,MAAM,MAAM,cAAc,CAAC,IAAI,SAAS,aAAa,IAAI,qBAAqB,CAAC,IAAI,CAAC,GAAG;IACtF,kCAAkC;IAClC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAA;IAClB,uCAAuC;IACvC,QAAQ,CAAC,YAAY,EAAE,IAAI,CAAC,cAAc,CAAC,CAAA;CAC3C,CAAA;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,cAAc,CAAC,IAAI,SAAS,aAAa,EAAE,GAAG,EAAE,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,CA6CzF"}

package/dist/contracts/contract.js

@@ -0,0 +1,107 @@
+/**
+ * ABI-Driven Contract Factory
+ *
+ * Generates fully-typed contract interfaces from `as const` ABI definitions,
+ * similar to viem's getContract() or ethers typechain.
+ *
+ * Each function declared in the ABI becomes a typed method on the contract
+ * object — with autocomplete for function names and typed params derived
+ * from the ABI inputs.
+ *
+ * @example
+ * ```ts
+ * import { createContract, LOCKUP_PRIME_ABI, toAtomicAma } from '@amadeus-protocol/sdk'
+ *
+ * // Unsigned — returns ContractCall for TransactionBuilder.signCall()
+ * const lockupPrime = createContract(LOCKUP_PRIME_ABI)
+ * const call = lockupPrime.lock({ amount: toAtomicAma(100).toString(), tier: '30d' })
+ * const { txHash, txPacked } = TransactionBuilder.signCall(privateKey, call)
+ *
+ * // Signed — bind a private key, methods return BuildTransactionResult directly
+ * const signed = createContract(LOCKUP_PRIME_ABI).connect(privateKey)
+ * const result = signed.lock({ amount: toAtomicAma(100).toString(), tier: '30d' })
+ * ```
+ */
+import { signContractCall } from '../signing';
+import { buildContractCall } from './contract-call';
+// ── Factory functions ───────────────────────────────────────────────
+/**
+ * Create a typed contract interface from an ABI definition.
+ *
+ * Returns an object where each ABI function is a method with fully typed
+ * params (derived from ABI inputs) and autocomplete on function names.
+ *
+ * @param abi - An ABI definition object (must be declared `as const`)
+ * @returns A typed `TypedContract<TAbi>` with methods for each ABI function
+ *
+ * @example
+ * ```ts
+ * import { createContract, LOCKUP_PRIME_ABI, LOCKUP_ABI, toAtomicAma } from '@amadeus-protocol/sdk'
+ *
+ * // Each ABI function becomes a typed method:
+ * const lockupPrime = createContract(LOCKUP_PRIME_ABI)
+ * lockupPrime.lock({ amount: toAtomicAma(100).toString(), tier: '30d' })   // typed
+ * lockupPrime.unlock({ vaultIndex: '3' })                                   // typed
+ * lockupPrime.daily_checkin({ vaultIndex: '7' })                            // typed
+ *
+ * // Sign the call:
+ * const call = lockupPrime.lock({ amount: '100000000000', tier: '30d' })
+ * const { txHash, txPacked } = TransactionBuilder.signCall(privateKey, call)
+ *
+ * // Or bind a signer:
+ * const signed = lockupPrime.connect(privateKey)
+ * const result = signed.lock({ amount: '100000000000', tier: '30d' })
+ * ```
+ */
+export function createContract(abi) {
+    if (!abi || typeof abi !== 'object') {
+        throw new Error('Invalid ABI: expected an object');
+    }
+    if (typeof abi.contractName !== 'string' || !abi.contractName) {
+        throw new Error('Invalid ABI: missing or empty "contractName"');
+    }
+    if (!Array.isArray(abi.abi)) {
+        throw new Error(`Invalid ABI for ${abi.contractName}: "abi" must be an array of functions`);
+    }
+    for (const fn of abi.abi) {
+        if (fn.type !== 'function') {
+            throw new Error(`Invalid ABI for ${abi.contractName}: entry "${fn.name ?? '?'}" has type "${fn.type}", expected "function"`);
+        }
+        if (typeof fn.name !== 'string' || !fn.name) {
+            throw new Error(`Invalid ABI for ${abi.contractName}: function entry missing "name"`);
+        }
+        if (!Array.isArray(fn.inputs)) {
+            throw new Error(`Invalid ABI for ${abi.contractName}: function "${fn.name}" missing "inputs" array`);
+        }
+    }
+    const contract = {
+        abi,
+        contractName: abi.contractName,
+        connect(privateKey) {
+            return createSignedContract(abi, privateKey);
+        }
+    };
+    for (const fn of abi.abi) {
+        contract[fn.name] = (params) => {
+            return buildContractCall(abi, fn.name, (params ?? {}));
+        };
+    }
+    return contract;
+}
+/**
+ * Create a signer-bound contract where each method builds + signs in one step.
+ */
+function createSignedContract(abi, privateKey) {
+    const contract = {
+        abi,
+        contractName: abi.contractName
+    };
+    for (const fn of abi.abi) {
+        contract[fn.name] = (params) => {
+            const call = buildContractCall(abi, fn.name, (params ?? {}));
+            return signContractCall(privateKey, call);
+        };
+    }
+    return contract;
+}
+//# sourceMappingURL=contract.js.map

package/dist/contracts/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../../src/contracts/contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAG7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAsEnD,uEAAuE;AAEvE;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,cAAc,CAA6B,GAAS;IACnE,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAA;IACnD,CAAC;IACD,IAAI,OAAO,GAAG,CAAC,YAAY,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;QAC/D,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAA;IAChE,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,mBAAmB,GAAG,CAAC,YAAY,uCAAuC,CAAC,CAAA;IAC5F,CAAC;IACD,KAAK,MAAM,EAAE,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC;QAC1B,IAAI,EAAE,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CACd,mBAAmB,GAAG,CAAC,YAAY,YAAY,EAAE,CAAC,IAAI,IAAI,GAAG,eAAe,EAAE,CAAC,IAAI,wBAAwB,CAC3G,CAAA;QACF,CAAC;QACD,IAAI,OAAO,EAAE,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;YAC7C,MAAM,IAAI,KAAK,CAAC,mBAAmB,GAAG,CAAC,YAAY,iCAAiC,CAAC,CAAA;QACtF,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CACd,mBAAmB,GAAG,CAAC,YAAY,eAAe,EAAE,CAAC,IAAI,0BAA0B,CACnF,CAAA;QACF,CAAC;IACF,CAAC;IAED,MAAM,QAAQ,GAA4B;QACzC,GAAG;QACH,YAAY,EAAE,GAAG,CAAC,YAAY;QAC9B,OAAO,CAAC,UAAkB;YACzB,OAAO,oBAAoB,CAAC,GAAG,EAAE,UAAU,CAAC,CAAA;QAC7C,CAAC;KACD,CAAA;IAED,KAAK,MAAM,EAAE,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC;QAC1B,QAAQ,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,MAA+B,EAAE,EAAE;YACvD,OAAO,iBAAiB,CACvB,GAAG,EACH,EAAE,CAAC,IAAa,EAChB,CAAC,MAAM,IAAI,EAAE,CAAU,CACvB,CAAA;QACF,CAAC,CAAA;IACF,CAAC;IAED,OAAO,QAA+B,CAAA;AACvC,CAAC;AAED;;GAEG;AACH,SAAS,oBAAoB,CAC5B,GAAS,EACT,UAAkB;IAElB,MAAM,QAAQ,GAA4B;QACzC,GAAG;QACH,YAAY,EAAE,GAAG,CAAC,YAAY;KAC9B,CAAA;IAED,KAAK,MAAM,EAAE,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC;QAC1B,QAAQ,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,MAA+B,EAAE,EAAE;YACvD,MAAM,IAAI,GAAG,iBAAiB,CAC7B,GAAG,EACH,EAAE,CAAC,IAAa,EAChB,CAAC,MAAM,IAAI,EAAE,CAAU,CACvB,CAAA;YACD,OAAO,gBAAgB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAA;QAC1C,CAAC,CAAA;IACF,CAAC;IAED,OAAO,QAAgC,CAAA;AACxC,CAAC"}

package/dist/contracts/index.d.ts

@@ -0,0 +1,7 @@
+export * from './abi-types';
+export * from './contract-call';
+export * from './contract';
+export * from './coin';
+export * from './lockup-prime';
+export * from './lockup';
+//# sourceMappingURL=index.d.ts.map

package/dist/contracts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contracts/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,YAAY,CAAA;AAC1B,cAAc,QAAQ,CAAA;AACtB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,UAAU,CAAA"}

package/dist/contracts/index.js

@@ -0,0 +1,7 @@
+export * from './abi-types';
+export * from './contract-call';
+export * from './contract';
+export * from './coin';
+export * from './lockup-prime';
+export * from './lockup';
+//# sourceMappingURL=index.js.map

package/dist/contracts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/contracts/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,YAAY,CAAA;AAC1B,cAAc,QAAQ,CAAA;AACtB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,UAAU,CAAA"}

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

@@ -0,0 +1,62 @@
+/**
+ * Lockup Smart Contract ABI
+ *
+ * Standard ABI format
+ * Based on: /root/node/ex/native/rdb/src/consensus/bic/lockup.rs
+ */
+export declare const LOCKUP_ABI: {
+    readonly contractName: "Lockup";
+    readonly contractVersion: "1.0.0";
+    readonly abi: readonly [{
+        readonly type: "function";
+        readonly name: "unlock";
+        readonly inputs: readonly [{
+            readonly name: "vaultIndex";
+            readonly type: "string";
+            readonly description: "Vault index to unlock (as string, e.g., \"0\", \"1\", \"2\")";
+        }];
+        readonly outputs: readonly [];
+        readonly stateMutability: "nonpayable";
+        readonly description: "Unlock a vault and receive locked tokens";
+        readonly requirements: readonly ["vault must exist", "vault must belong to caller", "entry_height >= unlock_height"];
+        readonly storage: {
+            readonly reads: readonly [{
+                readonly key: "bic:lockup:vault:{caller}:{vault_index}";
+                readonly value: "{unlock_height}-{amount}-{symbol}";
+                readonly description: "Reads vault data";
+            }];
+            readonly writes: readonly [{
+                readonly key: "bic:lockup:vault:{caller}:{vault_index}";
+                readonly operation: "delete";
+                readonly description: "Deletes vault after unlock";
+            }, {
+                readonly key: "bic:coin:balance:{caller}:AMA";
+                readonly operation: "increment";
+                readonly amount: "amount";
+                readonly description: "Returns locked AMA tokens";
+            }];
+        };
+    }];
+    readonly storage: {
+        readonly keys: readonly [{
+            readonly name: "vault";
+            readonly pattern: "bic:lockup:vault:{account}:{index}";
+            readonly type: "mapping";
+            readonly description: "Lockup vault storage key";
+            readonly valueFormat: "string";
+            readonly valueSchema: {
+                readonly type: "string";
+                readonly format: "{unlock_height}-{amount}-{symbol}";
+                readonly description: "Vault data format: unlock_height-amount-symbol";
+            };
+            readonly query: {
+                readonly method: "POST";
+                readonly endpoint: "/contract/get_prefix";
+                readonly prefix: "bic:lockup:vault:{account_binary}:";
+                readonly description: "Get all vaults for an account";
+            };
+        }];
+    };
+    readonly errors: readonly [];
+};
+//# sourceMappingURL=abi.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"abi.d.ts","sourceRoot":"","sources":["../../../src/contracts/lockup/abi.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqEb,CAAA"}

package/dist/contracts/lockup/abi.js

@@ -0,0 +1,77 @@
+/**
+ * Lockup Smart Contract ABI
+ *
+ * Standard ABI format
+ * Based on: /root/node/ex/native/rdb/src/consensus/bic/lockup.rs
+ */
+export const LOCKUP_ABI = {
+    contractName: 'Lockup',
+    contractVersion: '1.0.0',
+    abi: [
+        {
+            type: 'function',
+            name: 'unlock',
+            inputs: [
+                {
+                    name: 'vaultIndex',
+                    type: 'string',
+                    description: 'Vault index to unlock (as string, e.g., "0", "1", "2")'
+                }
+            ],
+            outputs: [],
+            stateMutability: 'nonpayable',
+            description: 'Unlock a vault and receive locked tokens',
+            requirements: [
+                'vault must exist',
+                'vault must belong to caller',
+                'entry_height >= unlock_height'
+            ],
+            storage: {
+                reads: [
+                    {
+                        key: 'bic:lockup:vault:{caller}:{vault_index}',
+                        value: '{unlock_height}-{amount}-{symbol}',
+                        description: 'Reads vault data'
+                    }
+                ],
+                writes: [
+                    {
+                        key: 'bic:lockup:vault:{caller}:{vault_index}',
+                        operation: 'delete',
+                        description: 'Deletes vault after unlock'
+                    },
+                    {
+                        key: 'bic:coin:balance:{caller}:AMA',
+                        operation: 'increment',
+                        amount: 'amount',
+                        description: 'Returns locked AMA tokens'
+                    }
+                ]
+            }
+        }
+    ],
+    storage: {
+        keys: [
+            {
+                name: 'vault',
+                pattern: 'bic:lockup:vault:{account}:{index}',
+                type: 'mapping',
+                description: 'Lockup vault storage key',
+                valueFormat: 'string',
+                valueSchema: {
+                    type: 'string',
+                    format: '{unlock_height}-{amount}-{symbol}',
+                    description: 'Vault data format: unlock_height-amount-symbol'
+                },
+                query: {
+                    method: 'POST',
+                    endpoint: '/contract/get_prefix',
+                    prefix: 'bic:lockup:vault:{account_binary}:',
+                    description: 'Get all vaults for an account'
+                }
+            }
+        ]
+    },
+    errors: []
+};
+//# sourceMappingURL=abi.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"abi.js","sourceRoot":"","sources":["../../../src/contracts/lockup/abi.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACzB,YAAY,EAAE,QAAQ;IACtB,eAAe,EAAE,OAAO;IACxB,GAAG,EAAE;QACJ;YACC,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,QAAQ;YACd,MAAM,EAAE;gBACP;oBACC,IAAI,EAAE,YAAY;oBAClB,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,wDAAwD;iBACrE;aACD;YACD,OAAO,EAAE,EAAE;YACX,eAAe,EAAE,YAAY;YAC7B,WAAW,EAAE,0CAA0C;YACvD,YAAY,EAAE;gBACb,kBAAkB;gBAClB,6BAA6B;gBAC7B,+BAA+B;aAC/B;YACD,OAAO,EAAE;gBACR,KAAK,EAAE;oBACN;wBACC,GAAG,EAAE,yCAAyC;wBAC9C,KAAK,EAAE,mCAAmC;wBAC1C,WAAW,EAAE,kBAAkB;qBAC/B;iBACD;gBACD,MAAM,EAAE;oBACP;wBACC,GAAG,EAAE,yCAAyC;wBAC9C,SAAS,EAAE,QAAQ;wBACnB,WAAW,EAAE,4BAA4B;qBACzC;oBACD;wBACC,GAAG,EAAE,+BAA+B;wBACpC,SAAS,EAAE,WAAW;wBACtB,MAAM,EAAE,QAAQ;wBAChB,WAAW,EAAE,2BAA2B;qBACxC;iBACD;aACD;SACD;KACD;IACD,OAAO,EAAE;QACR,IAAI,EAAE;YACL;gBACC,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,oCAAoC;gBAC7C,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,0BAA0B;gBACvC,WAAW,EAAE,QAAQ;gBACrB,WAAW,EAAE;oBACZ,IAAI,EAAE,QAAQ;oBACd,MAAM,EAAE,mCAAmC;oBAC3C,WAAW,EAAE,gDAAgD;iBAC7D;gBACD,KAAK,EAAE;oBACN,MAAM,EAAE,MAAM;oBACd,QAAQ,EAAE,sBAAsB;oBAChC,MAAM,EAAE,oCAAoC;oBAC5C,WAAW,EAAE,+BAA+B;iBAC5C;aACD;SACD;KACD;IACD,MAAM,EAAE,EAAE;CACD,CAAA"}

package/dist/contracts/lockup/calls.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Lockup Contract Call Builders
+ *
+ * Typed convenience builders that handle domain-to-ABI translation
+ * and return ContractCall objects.
+ */
+import type { ContractCall } from '../contract-call';
+import { LOCKUP_ABI } from './abi';
+/**
+ * Build a Lockup `unlock` call.
+ *
+ * @param params.vaultIndex - Vault index to unlock
+ *
+ * @example
+ * ```ts
+ * const call = buildLockupUnlock({ vaultIndex: 5 })
+ * TransactionBuilder.signCall(privateKey, call)
+ * ```
+ */
+export declare function buildLockupUnlock(params: {
+    vaultIndex: number | string;
+}): ContractCall<typeof LOCKUP_ABI, 'unlock'>;
+//# sourceMappingURL=calls.d.ts.map

package/dist/contracts/lockup/calls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calls.d.ts","sourceRoot":"","sources":["../../../src/contracts/lockup/calls.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAEpD,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAA;AAElC;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IACzC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAA;CAC3B,GAAG,YAAY,CAAC,OAAO,UAAU,EAAE,QAAQ,CAAC,CAI5C"}

package/dist/contracts/lockup/calls.js

@@ -0,0 +1,25 @@
+/**
+ * Lockup Contract Call Builders
+ *
+ * Typed convenience builders that handle domain-to-ABI translation
+ * and return ContractCall objects.
+ */
+import { buildContractCall } from '../contract-call';
+import { LOCKUP_ABI } from './abi';
+/**
+ * Build a Lockup `unlock` call.
+ *
+ * @param params.vaultIndex - Vault index to unlock
+ *
+ * @example
+ * ```ts
+ * const call = buildLockupUnlock({ vaultIndex: 5 })
+ * TransactionBuilder.signCall(privateKey, call)
+ * ```
+ */
+export function buildLockupUnlock(params) {
+    return buildContractCall(LOCKUP_ABI, 'unlock', {
+        vaultIndex: params.vaultIndex.toString()
+    });
+}
+//# sourceMappingURL=calls.js.map

package/dist/contracts/lockup/calls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calls.js","sourceRoot":"","sources":["../../../src/contracts/lockup/calls.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAA;AAElC;;;;;;;;;;GAUG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAEjC;IACA,OAAO,iBAAiB,CAAC,UAAU,EAAE,QAAQ,EAAE;QAC9C,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE;KACxC,CAAC,CAAA;AACH,CAAC"}

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

@@ -0,0 +1,24 @@
+import type { LockupAbiError, LockupAbiFunction, LockupAbiStorageKey } from './types';
+/**
+ * Lockup Contract Interface
+ * Provides access to contract ABI and transaction building utilities
+ */
+export declare class Lockup {
+    /** Get function ABI by name */
+    static getFunction(name: string): LockupAbiFunction | undefined;
+    /** Get error by code */
+    static getError(_code: string): LockupAbiError | undefined;
+    /** Get storage key by name */
+    static getStorageKey(name: string): LockupAbiStorageKey | undefined;
+    /**
+     * Build transaction arguments for a function
+     * @deprecated Use `buildContractCall(LOCKUP_ABI, functionName, params)` or
+     * the typed builder `buildLockupUnlock({ vaultIndex })` instead.
+     */
+    static buildArgs(functionName: string, params: Record<string, any>): Uint8Array[];
+    /** Get contract name */
+    static getContractName(): string;
+    /** Get key prefix for a storage key name */
+    static getKeyPrefix(keyName: string): string | undefined;
+}
+//# sourceMappingURL=helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/contracts/lockup/helpers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAA;AAErF;;;GAGG;AACH,qBAAa,MAAM;IAClB,+BAA+B;IAC/B,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAI/D,wBAAwB;IACxB,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI1D,8BAA8B;IAC9B,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS;IAInE;;;;OAIG;IACH,MAAM,CAAC,SAAS,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,UAAU,EAAE;IAiBjF,wBAAwB;IACxB,MAAM,CAAC,eAAe,IAAI,MAAM;IAIhC,4CAA4C;IAC5C,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAIxD"}

package/dist/contracts/lockup/helpers.js

@@ -0,0 +1,49 @@
+import { LOCKUP_ABI } from './abi';
+/**
+ * Lockup Contract Interface
+ * Provides access to contract ABI and transaction building utilities
+ */
+export class Lockup {
+    /** Get function ABI by name */
+    static getFunction(name) {
+        return LOCKUP_ABI.abi.find((f) => f.name === name);
+    }
+    /** Get error by code */
+    static getError(_code) {
+        return undefined;
+    }
+    /** Get storage key by name */
+    static getStorageKey(name) {
+        return LOCKUP_ABI.storage.keys.find((k) => k.name === name);
+    }
+    /**
+     * Build transaction arguments for a function
+     * @deprecated Use `buildContractCall(LOCKUP_ABI, functionName, params)` or
+     * the typed builder `buildLockupUnlock({ vaultIndex })` instead.
+     */
+    static buildArgs(functionName, params) {
+        const func = this.getFunction(functionName);
+        if (!func) {
+            throw new Error(`Function ${functionName} not found`);
+        }
+        const args = [];
+        for (const input of func.inputs) {
+            const value = params[input.name];
+            if (value === undefined) {
+                throw new Error(`Missing parameter: ${input.name}`);
+            }
+            args.push(new TextEncoder().encode(String(value)));
+        }
+        return args;
+    }
+    /** Get contract name */
+    static getContractName() {
+        return LOCKUP_ABI.contractName;
+    }
+    /** Get key prefix for a storage key name */
+    static getKeyPrefix(keyName) {
+        const storageKey = this.getStorageKey(keyName);
+        return storageKey?.pattern.split('{')[0];
+    }
+}
+//# sourceMappingURL=helpers.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/contracts/lockup/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAA;AAGlC;;;GAGG;AACH,MAAM,OAAO,MAAM;IAClB,+BAA+B;IAC/B,MAAM,CAAC,WAAW,CAAC,IAAY;QAC9B,OAAO,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAiC,CAAA;IACnF,CAAC;IAED,wBAAwB;IACxB,MAAM,CAAC,QAAQ,CAAC,KAAa;QAC5B,OAAO,SAAS,CAAA;IACjB,CAAC;IAED,8BAA8B;IAC9B,MAAM,CAAC,aAAa,CAAC,IAAY;QAChC,OAAO,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAA;IAC5D,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,SAAS,CAAC,YAAoB,EAAE,MAA2B;QACjE,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,CAAA;QAC3C,IAAI,CAAC,IAAI,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,YAAY,YAAY,YAAY,CAAC,CAAA;QACtD,CAAC;QAED,MAAM,IAAI,GAAiB,EAAE,CAAA;QAC7B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACjC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;YAChC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACzB,MAAM,IAAI,KAAK,CAAC,sBAAsB,KAAK,CAAC,IAAI,EAAE,CAAC,CAAA;YACpD,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;QACnD,CAAC;QACD,OAAO,IAAI,CAAA;IACZ,CAAC;IAED,wBAAwB;IACxB,MAAM,CAAC,eAAe;QACrB,OAAO,UAAU,CAAC,YAAY,CAAA;IAC/B,CAAC;IAED,4CAA4C;IAC5C,MAAM,CAAC,YAAY,CAAC,OAAe;QAClC,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAA;QAC9C,OAAO,UAAU,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;IACzC,CAAC;CACD"}

package/dist/contracts/lockup/index.d.ts

@@ -0,0 +1,6 @@
+export * from './abi';
+export * from './types';
+export * from './helpers';
+export * from './parsers';
+export * from './storage-keys';
+//# sourceMappingURL=index.d.ts.map

package/dist/contracts/lockup/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/contracts/lockup/index.ts"],"names":[],"mappings":"AAAA,cAAc,OAAO,CAAA;AACrB,cAAc,SAAS,CAAA;AACvB,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA"}

package/dist/contracts/lockup/index.js

@@ -0,0 +1,6 @@
+export * from './abi';
+export * from './types';
+export * from './helpers';
+export * from './parsers';
+export * from './storage-keys';
+//# sourceMappingURL=index.js.map

package/dist/contracts/lockup/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/contracts/lockup/index.ts"],"names":[],"mappings":"AAAA,cAAc,OAAO,CAAA;AACrB,cAAc,SAAS,CAAA;AACvB,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA"}

package/dist/contracts/lockup/parsers.d.ts

@@ -0,0 +1,20 @@
+import type { LockupVault, RawLockupVaultData } from './types';
+/**
+ * Parse raw lockup vault data string into intermediate format
+ * Format: {unlock_height}-{amount}-{symbol}
+ *
+ * @param dataStr - Raw vault data string from contract state
+ * @returns Parsed data or null if invalid
+ */
+export declare function parseRawLockupVaultData(dataStr: string): RawLockupVaultData | null;
+/**
+ * Parse lockup vault data from contract state
+ * Format: {unlock_height}-{amount}-{symbol}
+ * These vaults are locked for 5 epochs (100,000 * 5 = 500,000 heights)
+ *
+ * @param vaultData - Raw vault data from contract state (string or Uint8Array)
+ * @param vaultIndex - The vault index
+ * @returns Parsed vault or null if invalid
+ */
+export declare function parseLockupVaultData(vaultData: string | Uint8Array, vaultIndex: number): LockupVault | null;
+//# sourceMappingURL=parsers.d.ts.map

package/dist/contracts/lockup/parsers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsers.d.ts","sourceRoot":"","sources":["../../../src/contracts/lockup/parsers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AAE9D;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAalF;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CACnC,SAAS,EAAE,MAAM,GAAG,UAAU,EAC9B,UAAU,EAAE,MAAM,GAChB,WAAW,GAAG,IAAI,CA+BpB"}