@amadeus-protocol/sdk 1.0.7 → 1.1.0

package/dist/transaction-builder.js

@@ -1,346 +1,297 @@
+import { deriveSkAndSeed64FromBase58Seed, getPublicKey } from "./crypto.js";
+import { toAtomicAma } from "./conversion.js";
+import { buildAndSignRaw, buildUnsigned, buildUnsignedFromCall, normalizeSignerSk, signContractCall, signUnsigned } from "./signing.js";
+import { createContract } from "./contracts/contract.js";
+import { buildCoinTransfer } from "./contracts/coin.js";
+import { LOCKUP_PRIME_ABI } from "./contracts/lockup-prime/abi.js";
+import { LOCKUP_ABI } from "./contracts/lockup/abi.js";
+import { buildNftCreateCollection, buildNftMint, buildNftTransfer } from "./contracts/nft/helpers.js";
+//#region src/transaction-builder.ts
 /**
- * Transaction Builder
- *
- * Class-based API for building and signing Amadeus protocol transactions.
- * Delegates to the signing primitives in `signing.ts` and the ABI-driven
- * contract factory in `contracts/contract.ts`.
- *
- * ## Recommended: ABI-driven API
- *
- * ```ts
- * import { TransactionBuilder, LOCKUP_PRIME_ABI, toAtomicAma } from '@amadeus-protocol/sdk'
- *
- * // Via builder.contract(abi) — typed methods, auto-signed:
- * const builder = new TransactionBuilder('5Kd3N...')
- * const result = builder.contract(LOCKUP_PRIME_ABI).lock({
- *   amount: toAtomicAma(100).toString(),
- *   tier: '30d'
- * })
- *
- * // Or standalone:
- * import { createContract } from '@amadeus-protocol/sdk'
- * const lockupPrime = createContract(LOCKUP_PRIME_ABI)
- * const call = lockupPrime.lock({ amount: toAtomicAma(100).toString(), tier: '30d' })
- * const result = TransactionBuilder.signCall('5Kd3N...', call)
- * ```
- */
-import { deriveSkAndSeed64FromBase58Seed, getPublicKey } from './crypto';
-import { toAtomicAma } from './conversion';
-import { buildUnsigned, buildUnsignedFromCall, buildAndSignRaw, signUnsigned, signContractCall, normalizeSignerSk } from './signing';
-import { createContract } from './contracts/contract';
-import { buildCoinTransfer } from './contracts/coin';
-import { LOCKUP_PRIME_ABI } from './contracts/lockup-prime/abi';
-import { LOCKUP_ABI } from './contracts/lockup/abi';
-/**
- * Transaction Builder for Amadeus Protocol
- *
- * Provides methods for building and signing transactions. Can be instantiated
- * with a private key for convenience, or used statically.
- *
- * @example
- * ```ts
- * // ABI-driven (recommended)
- * const builder = new TransactionBuilder('5Kd3N...')
- * const result = builder.contract(LOCKUP_PRIME_ABI).lock({
- *   amount: toAtomicAma(100).toString(),
- *   tier: '30d'
- * })
- *
- * // Generic build/sign
- * const builder = new TransactionBuilder('5Kd3N...')
- * const { txHash, txPacked } = builder.buildAndSign('Coin', 'transfer', [
- *   recipientBytes, '1000000000', 'AMA'
- * ])
- * ```
- */
-export class TransactionBuilder {
-    privateKey;
-    signerPk = null;
-    signerSk = null;
-    /**
-     * Create a new TransactionBuilder instance
-     *
-     * @param privateKey - Optional Base58 encoded private key (seed). If provided,
-     *                     the builder will use this key for all transactions.
-     */
-    constructor(privateKey) {
-        this.privateKey = privateKey || null;
-        if (this.privateKey) {
-            this.initializeKeys();
-        }
-    }
-    /**
-     * Initialize signer keys from the private key
-     */
-    initializeKeys() {
-        if (!this.privateKey) {
-            throw new Error('Private key not set');
-        }
-        const { seed64, sk } = deriveSkAndSeed64FromBase58Seed(this.privateKey);
-        this.signerPk = getPublicKey(seed64);
-        this.signerSk = sk;
-    }
-    /**
-     * Get the signer's secret key (normalizes to PrivKey format)
-     */
-    getSignerSk(signerSk) {
-        if (signerSk) {
-            return normalizeSignerSk(signerSk);
-        }
-        if (this.signerSk) {
-            return this.signerSk;
-        }
-        if (this.privateKey) {
-            return normalizeSignerSk(this.privateKey);
-        }
-        throw new Error('Secret key required for signing');
-    }
-    requirePk(signerPk) {
-        const pk = signerPk || this.signerPk;
-        if (!pk) {
-            throw new Error('Signer public key required. Provide key or initialize builder with private key.');
-        }
-        return pk;
-    }
-    // ========================================================================
-    // ABI-driven contract API
-    // ========================================================================
-    /**
-     * Get a typed, signer-bound contract interface from an ABI definition.
-     *
-     * Each ABI function becomes a method that builds and signs in one step,
-     * returning `BuildTransactionResult` directly.
-     *
-     * @param abi - An ABI definition object (declared `as const`)
-     * @returns A `SignedContract<TAbi>` with typed methods for each ABI function
-     *
-     * @example
-     * ```ts
-     * const builder = new TransactionBuilder('5Kd3N...')
-     *
-     * // LockupPrime — all methods auto-detected from ABI:
-     * const result = builder.contract(LOCKUP_PRIME_ABI).lock({
-     *   amount: toAtomicAma(100).toString(),
-     *   tier: '30d'
-     * })
-     *
-     * builder.contract(LOCKUP_PRIME_ABI).unlock({ vaultIndex: '3' })
-     * builder.contract(LOCKUP_PRIME_ABI).daily_checkin({ vaultIndex: '7' })
-     *
-     * // Lockup:
-     * builder.contract(LOCKUP_ABI).unlock({ vaultIndex: '5' })
-     *
-     * // Any future contract — just pass its ABI:
-     * builder.contract(SOME_NEW_ABI).someFunction({ param: 'value' })
-     * ```
-     */
-    contract(abi) {
-        if (!this.privateKey) {
-            throw new Error('Private key required. Initialize builder with private key.');
-        }
-        return createContract(abi).connect(this.privateKey);
-    }
-    // ========================================================================
-    // ContractCall-based API
-    // ========================================================================
-    /**
-     * Derive keys from a Base58 private key and sign a ContractCall.
-     *
-     * @param senderPrivkey - Base58 encoded private key (seed)
-     * @param call - A ContractCall from createContract(), buildContractCall(), or buildCoinTransfer()
-     * @returns Transaction hash and packed transaction
-     *
-     * @example
-     * ```ts
-     * const lockupPrime = createContract(LOCKUP_PRIME_ABI)
-     * const call = lockupPrime.lock({ amount: '100000000000', tier: '30d' })
-     * const { txHash, txPacked } = TransactionBuilder.signCall('5Kd3N...', call)
-     * ```
-     */
-    static signCall(senderPrivkey, call) {
-        return signContractCall(senderPrivkey, call);
-    }
-    /**
-     * Build an unsigned transaction from a ContractCall (static)
-     */
-    static buildFromCall(call, signerPk) {
-        return buildUnsignedFromCall(signerPk, call);
-    }
-    /**
-     * Build and sign a transaction from a ContractCall (static)
-     */
-    static buildAndSignCall(signerPk, signerSk, call) {
-        return buildAndSignRaw(signerPk, signerSk, call.contract, call.method, call.args);
-    }
-    /**
-     * Build an unsigned transaction from a ContractCall (instance)
-     */
-    buildFromCall(call) {
-        return buildUnsignedFromCall(this.requirePk(), call);
-    }
-    /**
-     * Build and sign a transaction from a ContractCall (instance)
-     */
-    buildAndSignCall(call) {
-        const pk = this.requirePk();
-        const sk = this.getSignerSk();
-        return buildAndSignRaw(pk, sk, call.contract, call.method, call.args);
-    }
-    // ========================================================================
-    // Generic build/sign methods
-    // ========================================================================
-    /**
-     * Build an unsigned transaction (instance)
-     */
-    build(contract, method, args, signerPk) {
-        return buildUnsigned(this.requirePk(signerPk), contract, method, args);
-    }
-    /**
-     * Sign an unsigned transaction (instance)
-     */
-    sign(unsignedTx, signerSk) {
-        return signUnsigned(unsignedTx, this.getSignerSk(signerSk));
-    }
-    /**
-     * Build and sign a generic transaction (instance)
-     */
-    buildAndSign(contract, method, args, signerPk, signerSk) {
-        const pk = this.requirePk(signerPk);
-        const sk = this.getSignerSk(signerSk);
-        return buildAndSignRaw(pk, sk, contract, method, args);
-    }
-    /**
-     * Build an unsigned transaction (static)
-     */
-    static build(signerPk, contract, method, args) {
-        return buildUnsigned(signerPk, contract, method, args);
-    }
-    /**
-     * Sign an unsigned transaction (static)
-     */
-    static sign(unsignedTx, signerSk) {
-        return signUnsigned(unsignedTx, signerSk);
-    }
-    /**
-     * Build and sign a generic transaction (static)
-     */
-    static buildAndSign(signerPk, signerSk, contract, method, args) {
-        return buildAndSignRaw(signerPk, signerSk, contract, method, args);
-    }
-    // ========================================================================
-    // Coin transfer (instance)
-    // ========================================================================
-    /**
-     * Build an unsigned Coin transfer transaction
-     */
-    buildTransfer(input) {
-        return this.buildFromCall(buildCoinTransfer(input));
-    }
-    /**
-     * Build and sign a Coin transfer transaction
-     */
-    transfer(input) {
-        if (!this.privateKey) {
-            throw new Error('Private key required. Initialize builder with private key or use static method.');
-        }
-        return this.buildAndSignCall(buildCoinTransfer(input));
-    }
-    // ========================================================================
-    // Coin transfer (static)
-    // ========================================================================
-    /**
-     * Build an unsigned Coin transfer transaction (static)
-     */
-    static buildTransfer(input, signerPk) {
-        return TransactionBuilder.buildFromCall(buildCoinTransfer(input), signerPk);
-    }
-    /**
-     * Build and sign a Coin transfer transaction (static)
-     */
-    static buildSignedTransfer(input) {
-        return TransactionBuilder.signCall(input.senderPrivkey, buildCoinTransfer({ recipient: input.recipient, amount: input.amount, symbol: input.symbol }));
-    }
-    // ========================================================================
-    // LockupPrime (instance)
-    // ========================================================================
-    /**
-     * Build and sign a LockupPrime lock transaction
-     */
-    lockupPrimeLock(input) {
-        return this.contract(LOCKUP_PRIME_ABI).lock({
-            amount: toAtomicAma(input.amount).toString(),
-            tier: input.tier
-        });
-    }
-    /**
-     * Build and sign a LockupPrime unlock transaction
-     */
-    lockupPrimeUnlock(input) {
-        return this.contract(LOCKUP_PRIME_ABI).unlock({
-            vaultIndex: input.vaultIndex.toString()
-        });
-    }
-    /**
-     * Build and sign a LockupPrime daily check-in transaction
-     */
-    lockupPrimeDailyCheckin(input) {
-        return this.contract(LOCKUP_PRIME_ABI).daily_checkin({
-            vaultIndex: input.vaultIndex.toString()
-        });
-    }
-    // ========================================================================
-    // Lockup (instance)
-    // ========================================================================
-    /**
-     * Build and sign a Lockup unlock transaction
-     */
-    lockupUnlock(input) {
-        return this.contract(LOCKUP_ABI).unlock({
-            vaultIndex: input.vaultIndex.toString()
-        });
-    }
-    // ========================================================================
-    // LockupPrime (static)
-    // ========================================================================
-    /**
-     * Build and sign a LockupPrime lock transaction (static)
-     */
-    static buildSignedLockupPrimeLock(input) {
-        const call = createContract(LOCKUP_PRIME_ABI).lock({
-            amount: toAtomicAma(input.amount).toString(),
-            tier: input.tier
-        });
-        return TransactionBuilder.signCall(input.senderPrivkey, call);
-    }
-    /**
-     * Build and sign a LockupPrime unlock transaction (static)
-     */
-    static buildSignedLockupPrimeUnlock(input) {
-        const call = createContract(LOCKUP_PRIME_ABI).unlock({
-            vaultIndex: input.vaultIndex.toString()
-        });
-        return TransactionBuilder.signCall(input.senderPrivkey, call);
-    }
-    /**
-     * Build and sign a LockupPrime daily check-in transaction (static)
-     */
-    static buildSignedLockupPrimeDailyCheckin(input) {
-        const call = createContract(LOCKUP_PRIME_ABI).daily_checkin({
-            vaultIndex: input.vaultIndex.toString()
-        });
-        return TransactionBuilder.signCall(input.senderPrivkey, call);
-    }
-    // ========================================================================
-    // Lockup (static)
-    // ========================================================================
-    /**
-     * Build and sign a Lockup unlock transaction (static)
-     */
-    static buildSignedLockupUnlock(input) {
-        const call = createContract(LOCKUP_ABI).unlock({
-            vaultIndex: input.vaultIndex.toString()
-        });
-        return TransactionBuilder.signCall(input.senderPrivkey, call);
-    }
-}
+* Transaction Builder for Amadeus Protocol
+*
+* Provides methods for building and signing transactions. Can be instantiated
+* with a private key for convenience, or used statically.
+*
+* @example
+* ```ts
+* // ABI-driven (recommended)
+* const builder = new TransactionBuilder('5Kd3N...')
+* const result = builder.contract(LOCKUP_PRIME_ABI).lock({
+*   amount: toAtomicAma(100).toString(),
+*   tier: '30d'
+* })
+*
+* // Generic build/sign
+* const builder = new TransactionBuilder('5Kd3N...')
+* const { txHash, txPacked } = builder.buildAndSign('Coin', 'transfer', [
+*   recipientBytes, '1000000000', 'AMA'
+* ])
+* ```
+*/
+var TransactionBuilder = class TransactionBuilder {
+	privateKey;
+	signerPk = null;
+	signerSk = null;
+	/**
+	* Create a new TransactionBuilder instance
+	*
+	* @param privateKey - Optional Base58 encoded private key (seed). If provided,
+	*                     the builder will use this key for all transactions.
+	*/
+	constructor(privateKey) {
+		this.privateKey = privateKey || null;
+		if (this.privateKey) this.initializeKeys();
+	}
+	/**
+	* Initialize signer keys from the private key
+	*/
+	initializeKeys() {
+		if (!this.privateKey) throw new Error("Private key not set");
+		const { seed64, sk } = deriveSkAndSeed64FromBase58Seed(this.privateKey);
+		this.signerPk = getPublicKey(seed64);
+		this.signerSk = sk;
+	}
+	/**
+	* Get the signer's secret key (normalizes to PrivKey format)
+	*/
+	getSignerSk(signerSk) {
+		if (signerSk) return normalizeSignerSk(signerSk);
+		if (this.signerSk) return this.signerSk;
+		if (this.privateKey) return normalizeSignerSk(this.privateKey);
+		throw new Error("Secret key required for signing");
+	}
+	requirePk(signerPk) {
+		const pk = signerPk || this.signerPk;
+		if (!pk) throw new Error("Signer public key required. Provide key or initialize builder with private key.");
+		return pk;
+	}
+	/**
+	* Get a typed, signer-bound contract interface from an ABI definition.
+	*
+	* Each ABI function becomes a method that builds and signs in one step,
+	* returning `BuildTransactionResult` directly.
+	*
+	* @param abi - An ABI definition object (declared `as const`)
+	* @returns A `SignedContract<TAbi>` with typed methods for each ABI function
+	*
+	* @example
+	* ```ts
+	* const builder = new TransactionBuilder('5Kd3N...')
+	*
+	* // LockupPrime — all methods auto-detected from ABI:
+	* const result = builder.contract(LOCKUP_PRIME_ABI).lock({
+	*   amount: toAtomicAma(100).toString(),
+	*   tier: '30d'
+	* })
+	*
+	* builder.contract(LOCKUP_PRIME_ABI).unlock({ vaultIndex: '3' })
+	* builder.contract(LOCKUP_PRIME_ABI).daily_checkin({ vaultIndex: '7' })
+	*
+	* // Lockup:
+	* builder.contract(LOCKUP_ABI).unlock({ vaultIndex: '5' })
+	*
+	* // Any future contract — just pass its ABI:
+	* builder.contract(SOME_NEW_ABI).someFunction({ param: 'value' })
+	* ```
+	*/
+	contract(abi) {
+		if (!this.privateKey) throw new Error("Private key required. Initialize builder with private key.");
+		return createContract(abi).connect(this.privateKey);
+	}
+	/**
+	* Derive keys from a Base58 private key and sign a ContractCall.
+	*
+	* @param senderPrivkey - Base58 encoded private key (seed)
+	* @param call - A ContractCall from createContract(), buildContractCall(), or buildCoinTransfer()
+	* @returns Transaction hash and packed transaction
+	*
+	* @example
+	* ```ts
+	* const lockupPrime = createContract(LOCKUP_PRIME_ABI)
+	* const call = lockupPrime.lock({ amount: '100000000000', tier: '30d' })
+	* const { txHash, txPacked } = TransactionBuilder.signCall('5Kd3N...', call)
+	* ```
+	*/
+	static signCall(senderPrivkey, call) {
+		return signContractCall(senderPrivkey, call);
+	}
+	/**
+	* Build an unsigned transaction from a ContractCall (static)
+	*/
+	static buildFromCall(call, signerPk) {
+		return buildUnsignedFromCall(signerPk, call);
+	}
+	/**
+	* Build and sign a transaction from a ContractCall (static)
+	*/
+	static buildAndSignCall(signerPk, signerSk, call) {
+		return buildAndSignRaw(signerPk, signerSk, call.contract, call.method, call.args);
+	}
+	/**
+	* Build an unsigned transaction from a ContractCall (instance)
+	*/
+	buildFromCall(call) {
+		return buildUnsignedFromCall(this.requirePk(), call);
+	}
+	/**
+	* Build and sign a transaction from a ContractCall (instance)
+	*/
+	buildAndSignCall(call) {
+		return buildAndSignRaw(this.requirePk(), this.getSignerSk(), call.contract, call.method, call.args);
+	}
+	/**
+	* Build an unsigned transaction (instance)
+	*/
+	build(contract, method, args, signerPk) {
+		return buildUnsigned(this.requirePk(signerPk), contract, method, args);
+	}
+	/**
+	* Sign an unsigned transaction (instance)
+	*/
+	sign(unsignedTx, signerSk) {
+		return signUnsigned(unsignedTx, this.getSignerSk(signerSk));
+	}
+	/**
+	* Build and sign a generic transaction (instance)
+	*/
+	buildAndSign(contract, method, args, signerPk, signerSk) {
+		return buildAndSignRaw(this.requirePk(signerPk), this.getSignerSk(signerSk), contract, method, args);
+	}
+	/**
+	* Build an unsigned transaction (static)
+	*/
+	static build(signerPk, contract, method, args) {
+		return buildUnsigned(signerPk, contract, method, args);
+	}
+	/**
+	* Sign an unsigned transaction (static)
+	*/
+	static sign(unsignedTx, signerSk) {
+		return signUnsigned(unsignedTx, signerSk);
+	}
+	/**
+	* Build and sign a generic transaction (static)
+	*/
+	static buildAndSign(signerPk, signerSk, contract, method, args) {
+		return buildAndSignRaw(signerPk, signerSk, contract, method, args);
+	}
+	/**
+	* Build an unsigned Coin transfer transaction
+	*/
+	buildTransfer(input) {
+		return this.buildFromCall(buildCoinTransfer(input));
+	}
+	/**
+	* Build and sign a Coin transfer transaction
+	*/
+	transfer(input) {
+		if (!this.privateKey) throw new Error("Private key required. Initialize builder with private key or use static method.");
+		return this.buildAndSignCall(buildCoinTransfer(input));
+	}
+	/**
+	* Build an unsigned Coin transfer transaction (static)
+	*/
+	static buildTransfer(input, signerPk) {
+		return TransactionBuilder.buildFromCall(buildCoinTransfer(input), signerPk);
+	}
+	/**
+	* Build and sign a Coin transfer transaction (static)
+	*/
+	static buildSignedTransfer(input) {
+		return TransactionBuilder.signCall(input.senderPrivkey, buildCoinTransfer({
+			recipient: input.recipient,
+			amount: input.amount,
+			symbol: input.symbol
+		}));
+	}
+	/**
+	* Build and sign a LockupPrime lock transaction
+	*/
+	lockupPrimeLock(input) {
+		return this.contract(LOCKUP_PRIME_ABI).lock({
+			amount: toAtomicAma(input.amount).toString(),
+			tier: input.tier
+		});
+	}
+	/**
+	* Build and sign a LockupPrime unlock transaction
+	*/
+	lockupPrimeUnlock(input) {
+		return this.contract(LOCKUP_PRIME_ABI).unlock({ vaultIndex: input.vaultIndex.toString() });
+	}
+	/**
+	* Build and sign a LockupPrime daily check-in transaction
+	*/
+	lockupPrimeDailyCheckin(input) {
+		return this.contract(LOCKUP_PRIME_ABI).daily_checkin({ vaultIndex: input.vaultIndex.toString() });
+	}
+	/**
+	* Build and sign a Lockup unlock transaction
+	*/
+	lockupUnlock(input) {
+		return this.contract(LOCKUP_ABI).unlock({ vaultIndex: input.vaultIndex.toString() });
+	}
+	/**
+	* Build and sign a LockupPrime lock transaction (static)
+	*/
+	static buildSignedLockupPrimeLock(input) {
+		const call = createContract(LOCKUP_PRIME_ABI).lock({
+			amount: toAtomicAma(input.amount).toString(),
+			tier: input.tier
+		});
+		return TransactionBuilder.signCall(input.senderPrivkey, call);
+	}
+	/**
+	* Build and sign a LockupPrime unlock transaction (static)
+	*/
+	static buildSignedLockupPrimeUnlock(input) {
+		const call = createContract(LOCKUP_PRIME_ABI).unlock({ vaultIndex: input.vaultIndex.toString() });
+		return TransactionBuilder.signCall(input.senderPrivkey, call);
+	}
+	/**
+	* Build and sign a LockupPrime daily check-in transaction (static)
+	*/
+	static buildSignedLockupPrimeDailyCheckin(input) {
+		const call = createContract(LOCKUP_PRIME_ABI).daily_checkin({ vaultIndex: input.vaultIndex.toString() });
+		return TransactionBuilder.signCall(input.senderPrivkey, call);
+	}
+	/**
+	* Build and sign a Lockup unlock transaction (static)
+	*/
+	static buildSignedLockupUnlock(input) {
+		const call = createContract(LOCKUP_ABI).unlock({ vaultIndex: input.vaultIndex.toString() });
+		return TransactionBuilder.signCall(input.senderPrivkey, call);
+	}
+	/** Build and sign an `Nft.transfer` transaction */
+	nftTransfer(input) {
+		if (!this.privateKey) throw new Error("Private key required. Initialize builder with private key or use static method.");
+		return this.buildAndSignCall(buildNftTransfer(input));
+	}
+	/** Build and sign an `Nft.mint` transaction (collection owner only) */
+	nftMint(input) {
+		if (!this.privateKey) throw new Error("Private key required. Initialize builder with private key or use static method.");
+		return this.buildAndSignCall(buildNftMint(input));
+	}
+	/** Build and sign an `Nft.create_collection` transaction */
+	nftCreateCollection(input) {
+		if (!this.privateKey) throw new Error("Private key required. Initialize builder with private key or use static method.");
+		return this.buildAndSignCall(buildNftCreateCollection(input));
+	}
+	/** Build and sign an `Nft.transfer` transaction (static) */
+	static buildSignedNftTransfer(input) {
+		return TransactionBuilder.signCall(input.senderPrivkey, buildNftTransfer(input));
+	}
+	/** Build and sign an `Nft.mint` transaction (static) */
+	static buildSignedNftMint(input) {
+		return TransactionBuilder.signCall(input.senderPrivkey, buildNftMint(input));
+	}
+	/** Build and sign an `Nft.create_collection` transaction (static) */
+	static buildSignedNftCreateCollection(input) {
+		return TransactionBuilder.signCall(input.senderPrivkey, buildNftCreateCollection(input));
+	}
+};
+//#endregion
+export { TransactionBuilder };
+
 //# sourceMappingURL=transaction-builder.js.map