@amadeus-protocol/sdk 1.0.0

package/dist/transaction-builder.d.ts

@@ -0,0 +1,267 @@
+/**
+ * Transaction Builder
+ *
+ * This module provides a class-based API for building and signing Amadeus protocol transactions.
+ */
+import type { PrivKey } from '@noble/curves/utils';
+import type { BuildTransactionResult, SerializableValue, TransferTransactionInput, UnsignedTransactionWithHash } from './types';
+/**
+ * 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
+ * // Instance-based usage
+ * const builder = new TransactionBuilder('5Kd3N...')
+ * const { txHash, txPacked } = builder.transfer({
+ *   recipient: '5Kd3N...',
+ *   amount: 10.5,
+ *   symbol: 'AMA'
+ * })
+ *
+ * // Static usage
+ * const { txHash, txPacked } = TransactionBuilder.buildTransfer({
+ *   senderPrivkey: '5Kd3N...',
+ *   recipient: '5Kd3N...',
+ *   amount: 10.5,
+ *   symbol: 'AMA'
+ * })
+ * ```
+ */
+export declare class TransactionBuilder {
+    private readonly privateKey;
+    private signerPk;
+    private signerSk;
+    /**
+     * Domain Separation Tag for transaction signatures
+     */
+    private static readonly TX_DST;
+    /**
+     * 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?: string);
+    /**
+     * Generate a transaction nonce based on current timestamp
+     */
+    private static generateNonce;
+    /**
+     * Create transaction structure
+     */
+    private static createTransaction;
+    /**
+     * Build an unsigned transaction (returns transaction structure and hash)
+     */
+    private static buildUnsignedTransaction;
+    /**
+     * Normalize signer secret key to PrivKey format (handles Base58 strings)
+     */
+    private static normalizeSignerSk;
+    /**
+     * Sign a transaction hash using BLS12-381 with transaction DST
+     */
+    private static signHash;
+    /**
+     * Sign an unsigned transaction
+     */
+    private static signTransaction;
+    /**
+     * Build and sign a transaction (convenience method)
+     */
+    private static buildAndSignTransaction;
+    /**
+     * Initialize signer keys from the private key
+     */
+    private initializeKeys;
+    /**
+     * Build an unsigned transaction
+     *
+     * @param contract - Contract name
+     * @param method - Method name
+     * @param args - Method arguments
+     * @param signerPk - Optional signer's public key (required if instance has no private key)
+     * @returns Unsigned transaction with hash
+     *
+     * @example
+     * ```ts
+     * const builder = new TransactionBuilder('5Kd3N...')
+     * const unsignedTx = builder.build('Coin', 'transfer', [
+     *   recipientBytes,
+     *   '1000000000',
+     *   'AMA'
+     * ])
+     * // Can inspect or modify before signing
+     * const { txHash, txPacked } = builder.sign(unsignedTx)
+     * ```
+     */
+    build(contract: string, method: string, args: SerializableValue[], signerPk?: Uint8Array): UnsignedTransactionWithHash;
+    /**
+     * Get the signer's secret key (normalizes to PrivKey format)
+     * Handles Base58 strings, PrivKey (Uint8Array), or uses cached/derived key
+     */
+    private getSignerSk;
+    /**
+     * Sign an unsigned transaction
+     *
+     * @param unsignedTx - Unsigned transaction with hash
+     * @param signerSk - Optional signer's secret key (required if instance has no private key)
+     * @returns Transaction hash and packed transaction
+     *
+     * @example
+     * ```ts
+     * const builder = new TransactionBuilder('5Kd3N...')
+     * const unsignedTx = builder.build('Coin', 'transfer', args)
+     * const { txHash, txPacked } = builder.sign(unsignedTx)
+     * ```
+     */
+    sign(unsignedTx: UnsignedTransactionWithHash, signerSk?: PrivKey | string | Uint8Array): BuildTransactionResult;
+    /**
+     * Build and sign a generic transaction (convenience method)
+     *
+     * @param contract - Contract name
+     * @param method - Method name
+     * @param args - Method arguments
+     * @param signerPk - Optional signer's public key (required if instance has no private key)
+     * @param signerSk - Optional signer's secret key (required if instance has no private key)
+     * @returns Transaction hash and packed transaction
+     *
+     * @example
+     * ```ts
+     * const builder = new TransactionBuilder('5Kd3N...')
+     * const { txHash, txPacked } = builder.buildAndSign('Coin', 'transfer', [
+     *   recipientBytes,
+     *   '1000000000',
+     *   'AMA'
+     * ])
+     * ```
+     */
+    buildAndSign(contract: string, method: string, args: SerializableValue[], signerPk?: Uint8Array, signerSk?: PrivKey | string | Uint8Array): BuildTransactionResult;
+    /**
+     * Build an unsigned transfer transaction
+     *
+     * @param input - Transfer transaction parameters
+     * @returns Unsigned transaction with hash
+     *
+     * @example
+     * ```ts
+     * const builder = new TransactionBuilder('5Kd3N...')
+     * const unsignedTx = builder.buildTransfer({
+     *   recipient: '5Kd3N...',
+     *   amount: 10.5,
+     *   symbol: 'AMA'
+     * })
+     * ```
+     */
+    buildTransfer(input: Omit<TransferTransactionInput, 'senderPrivkey'>): UnsignedTransactionWithHash;
+    /**
+     * Build and sign a transfer transaction (convenience method)
+     *
+     * @param input - Transfer transaction parameters
+     * @returns Transaction hash and packed transaction
+     *
+     * @example
+     * ```ts
+     * const builder = new TransactionBuilder('5Kd3N...')
+     * const { txHash, txPacked } = builder.transfer({
+     *   recipient: '5Kd3N...',
+     *   amount: 10.5,
+     *   symbol: 'AMA'
+     * })
+     * ```
+     */
+    transfer(input: Omit<TransferTransactionInput, 'senderPrivkey'>): BuildTransactionResult;
+    /**
+     * Build an unsigned transfer transaction (static method)
+     *
+     * @param input - Transfer transaction parameters (without senderPrivkey)
+     * @param signerPk - Signer's public key
+     * @returns Unsigned transaction with hash
+     *
+     * @example
+     * ```ts
+     * const unsignedTx = TransactionBuilder.buildTransfer(
+     *   { recipient: '5Kd3N...', amount: 10.5, symbol: 'AMA' },
+     *   publicKey
+     * )
+     * ```
+     */
+    static buildTransfer(input: Omit<TransferTransactionInput, 'senderPrivkey'>, signerPk: Uint8Array): UnsignedTransactionWithHash;
+    /**
+     * Build and sign a transfer transaction (static method)
+     *
+     * @param input - Transfer transaction parameters
+     * @returns Transaction hash and packed transaction
+     *
+     * @example
+     * ```ts
+     * const { txHash, txPacked } = TransactionBuilder.buildSignedTransfer({
+     *   senderPrivkey: '5Kd3N...',
+     *   recipient: '5Kd3N...',
+     *   amount: 10.5,
+     *   symbol: 'AMA'
+     * })
+     * ```
+     */
+    static buildSignedTransfer(input: TransferTransactionInput): BuildTransactionResult;
+    /**
+     * Build an unsigned transaction (static method)
+     *
+     * @param signerPk - Signer's public key
+     * @param contract - Contract name
+     * @param method - Method name
+     * @param args - Method arguments
+     * @returns Unsigned transaction with hash
+     *
+     * @example
+     * ```ts
+     * const unsignedTx = TransactionBuilder.build(
+     *   publicKey,
+     *   'Coin',
+     *   'transfer',
+     *   [recipientBytes, amount, 'AMA']
+     * )
+     * ```
+     */
+    static build(signerPk: Uint8Array, contract: string, method: string, args: SerializableValue[]): UnsignedTransactionWithHash;
+    /**
+     * Sign an unsigned transaction (static method)
+     *
+     * @param unsignedTx - Unsigned transaction with hash
+     * @param signerSk - Signer's secret key
+     * @returns Transaction hash and packed transaction
+     *
+     * @example
+     * ```ts
+     * const unsignedTx = TransactionBuilder.build(publicKey, 'Coin', 'transfer', args)
+     * const { txHash, txPacked } = TransactionBuilder.sign(unsignedTx, secretKey)
+     * ```
+     */
+    static sign(unsignedTx: UnsignedTransactionWithHash, signerSk: PrivKey | string | Uint8Array): BuildTransactionResult;
+    /**
+     * Build and sign a generic transaction (static method)
+     *
+     * @param signerPk - Signer's public key
+     * @param signerSk - Signer's secret key
+     * @param contract - Contract name
+     * @param method - Method name
+     * @param args - Method arguments
+     * @returns Transaction hash and packed transaction
+     *
+     * @example
+     * ```ts
+     * const { txHash, txPacked } = TransactionBuilder.buildAndSign(
+     *   publicKey,
+     *   secretKey,
+     *   'Coin',
+     *   'transfer',
+     *   [recipientBytes, amount, 'AMA']
+     * )
+     * ```
+     */
+    static buildAndSign(signerPk: Uint8Array, signerSk: PrivKey | string | Uint8Array, contract: string, method: string, args: SerializableValue[]): BuildTransactionResult;
+}
+//# sourceMappingURL=transaction-builder.d.ts.map

package/dist/transaction-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-builder.d.ts","sourceRoot":"","sources":["../src/transaction-builder.ts"],"names":[],"mappings":"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"}

package/dist/transaction-builder.js

@@ -0,0 +1,397 @@
+/**
+ * Transaction Builder
+ *
+ * This module provides a class-based API for building and signing Amadeus protocol transactions.
+ */
+import { bls12_381 as bls } from '@noble/curves/bls12-381';
+import { sha256 } from '@noble/hashes/sha2';
+import { deriveSkAndSeed64FromBase58Seed, getPublicKey } from './crypto';
+import { fromBase58, toBase58 } from './encoding';
+import { toAtomicAma } from './conversion';
+import { encode } from './serialization';
+/**
+ * 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
+ * // Instance-based usage
+ * const builder = new TransactionBuilder('5Kd3N...')
+ * const { txHash, txPacked } = builder.transfer({
+ *   recipient: '5Kd3N...',
+ *   amount: 10.5,
+ *   symbol: 'AMA'
+ * })
+ *
+ * // Static usage
+ * const { txHash, txPacked } = TransactionBuilder.buildTransfer({
+ *   senderPrivkey: '5Kd3N...',
+ *   recipient: '5Kd3N...',
+ *   amount: 10.5,
+ *   symbol: 'AMA'
+ * })
+ * ```
+ */
+export class TransactionBuilder {
+    privateKey;
+    signerPk = null;
+    signerSk = null;
+    /**
+     * Domain Separation Tag for transaction signatures
+     */
+    static TX_DST = 'AMADEUS_SIG_BLS12381G2_XMD:SHA-256_SSWU_RO_TX_';
+    /**
+     * 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();
+        }
+    }
+    /**
+     * Generate a transaction nonce based on current timestamp
+     */
+    static generateNonce() {
+        return BigInt(Date.now()) * 1000000n;
+    }
+    /**
+     * Create transaction structure
+     */
+    static createTransaction(signer, contract, method, args) {
+        const action = {
+            op: 'call',
+            contract,
+            function: method,
+            args
+        };
+        return {
+            signer,
+            nonce: TransactionBuilder.generateNonce(),
+            action
+        };
+    }
+    /**
+     * Build an unsigned transaction (returns transaction structure and hash)
+     */
+    static buildUnsignedTransaction(signerPk, contract, method, args) {
+        const tx = TransactionBuilder.createTransaction(signerPk, contract, method, args);
+        const txEncoded = encode(tx);
+        const hash = sha256(txEncoded);
+        return { tx, hash };
+    }
+    /**
+     * Normalize signer secret key to PrivKey format (handles Base58 strings)
+     */
+    static normalizeSignerSk(signerSk) {
+        if (typeof signerSk === 'string') {
+            // Base58 string - derive PrivKey from it
+            const { sk } = deriveSkAndSeed64FromBase58Seed(signerSk);
+            return sk;
+        }
+        // Already PrivKey (Uint8Array)
+        return signerSk;
+    }
+    /**
+     * Sign a transaction hash using BLS12-381 with transaction DST
+     */
+    static signHash(hash, signerSk) {
+        const normalizedSk = TransactionBuilder.normalizeSignerSk(signerSk);
+        return bls.sign(hash, normalizedSk, { DST: TransactionBuilder.TX_DST });
+    }
+    /**
+     * Sign an unsigned transaction
+     */
+    static signTransaction(unsignedTx, signerSk) {
+        const signature = TransactionBuilder.signHash(unsignedTx.hash, signerSk);
+        return {
+            txHash: toBase58(unsignedTx.hash),
+            txPacked: encode({ tx: unsignedTx.tx, hash: unsignedTx.hash, signature })
+        };
+    }
+    /**
+     * Build and sign a transaction (convenience method)
+     */
+    static buildAndSignTransaction(signerPk, signerSk, contract, method, args) {
+        const unsignedTx = TransactionBuilder.buildUnsignedTransaction(signerPk, contract, method, args);
+        return TransactionBuilder.signTransaction(unsignedTx, signerSk);
+    }
+    /**
+     * 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;
+    }
+    /**
+     * Build an unsigned transaction
+     *
+     * @param contract - Contract name
+     * @param method - Method name
+     * @param args - Method arguments
+     * @param signerPk - Optional signer's public key (required if instance has no private key)
+     * @returns Unsigned transaction with hash
+     *
+     * @example
+     * ```ts
+     * const builder = new TransactionBuilder('5Kd3N...')
+     * const unsignedTx = builder.build('Coin', 'transfer', [
+     *   recipientBytes,
+     *   '1000000000',
+     *   'AMA'
+     * ])
+     * // Can inspect or modify before signing
+     * const { txHash, txPacked } = builder.sign(unsignedTx)
+     * ```
+     */
+    build(contract, method, args, signerPk) {
+        const pk = signerPk || this.signerPk;
+        if (!pk) {
+            throw new Error('Signer public key required. Provide key or initialize builder with private key.');
+        }
+        return TransactionBuilder.buildUnsignedTransaction(pk, contract, method, args);
+    }
+    /**
+     * Get the signer's secret key (normalizes to PrivKey format)
+     * Handles Base58 strings, PrivKey (Uint8Array), or uses cached/derived key
+     */
+    getSignerSk(signerSk) {
+        // If provided, normalize it (convert Base58 string to PrivKey if needed)
+        if (signerSk) {
+            if (typeof signerSk === 'string') {
+                // Base58 string - derive PrivKey from it
+                const { sk } = deriveSkAndSeed64FromBase58Seed(signerSk);
+                return sk;
+            }
+            // Already PrivKey (Uint8Array)
+            return signerSk;
+        }
+        // Use cached signerSk if available
+        if (this.signerSk) {
+            return this.signerSk;
+        }
+        // Derive from privateKey
+        if (this.privateKey) {
+            const { sk } = deriveSkAndSeed64FromBase58Seed(this.privateKey);
+            return sk;
+        }
+        throw new Error('Secret key required for signing');
+    }
+    /**
+     * Sign an unsigned transaction
+     *
+     * @param unsignedTx - Unsigned transaction with hash
+     * @param signerSk - Optional signer's secret key (required if instance has no private key)
+     * @returns Transaction hash and packed transaction
+     *
+     * @example
+     * ```ts
+     * const builder = new TransactionBuilder('5Kd3N...')
+     * const unsignedTx = builder.build('Coin', 'transfer', args)
+     * const { txHash, txPacked } = builder.sign(unsignedTx)
+     * ```
+     */
+    sign(unsignedTx, signerSk) {
+        const sk = this.getSignerSk(signerSk);
+        return TransactionBuilder.signTransaction(unsignedTx, sk);
+    }
+    /**
+     * Build and sign a generic transaction (convenience method)
+     *
+     * @param contract - Contract name
+     * @param method - Method name
+     * @param args - Method arguments
+     * @param signerPk - Optional signer's public key (required if instance has no private key)
+     * @param signerSk - Optional signer's secret key (required if instance has no private key)
+     * @returns Transaction hash and packed transaction
+     *
+     * @example
+     * ```ts
+     * const builder = new TransactionBuilder('5Kd3N...')
+     * const { txHash, txPacked } = builder.buildAndSign('Coin', 'transfer', [
+     *   recipientBytes,
+     *   '1000000000',
+     *   'AMA'
+     * ])
+     * ```
+     */
+    buildAndSign(contract, method, args, signerPk, signerSk) {
+        const pk = signerPk || this.signerPk;
+        if (!pk) {
+            throw new Error('Signer public key required. Provide key or initialize builder with private key.');
+        }
+        const sk = this.getSignerSk(signerSk);
+        return TransactionBuilder.buildAndSignTransaction(pk, sk, contract, method, args);
+    }
+    /**
+     * Build an unsigned transfer transaction
+     *
+     * @param input - Transfer transaction parameters
+     * @returns Unsigned transaction with hash
+     *
+     * @example
+     * ```ts
+     * const builder = new TransactionBuilder('5Kd3N...')
+     * const unsignedTx = builder.buildTransfer({
+     *   recipient: '5Kd3N...',
+     *   amount: 10.5,
+     *   symbol: 'AMA'
+     * })
+     * ```
+     */
+    buildTransfer(input) {
+        if (!this.signerPk) {
+            throw new Error('Public key required. Initialize builder with private key or provide signerPk.');
+        }
+        return this.build('Coin', 'transfer', [
+            fromBase58(input.recipient),
+            toAtomicAma(input.amount).toString(),
+            input.symbol
+        ]);
+    }
+    /**
+     * Build and sign a transfer transaction (convenience method)
+     *
+     * @param input - Transfer transaction parameters
+     * @returns Transaction hash and packed transaction
+     *
+     * @example
+     * ```ts
+     * const builder = new TransactionBuilder('5Kd3N...')
+     * const { txHash, txPacked } = builder.transfer({
+     *   recipient: '5Kd3N...',
+     *   amount: 10.5,
+     *   symbol: 'AMA'
+     * })
+     * ```
+     */
+    transfer(input) {
+        if (!this.privateKey) {
+            throw new Error('Private key required. Initialize builder with private key or use static method.');
+        }
+        return this.buildAndSign('Coin', 'transfer', [
+            fromBase58(input.recipient),
+            toAtomicAma(input.amount).toString(),
+            input.symbol
+        ]);
+    }
+    /**
+     * Build an unsigned transfer transaction (static method)
+     *
+     * @param input - Transfer transaction parameters (without senderPrivkey)
+     * @param signerPk - Signer's public key
+     * @returns Unsigned transaction with hash
+     *
+     * @example
+     * ```ts
+     * const unsignedTx = TransactionBuilder.buildTransfer(
+     *   { recipient: '5Kd3N...', amount: 10.5, symbol: 'AMA' },
+     *   publicKey
+     * )
+     * ```
+     */
+    static buildTransfer(input, signerPk) {
+        return TransactionBuilder.buildUnsignedTransaction(signerPk, 'Coin', 'transfer', [
+            fromBase58(input.recipient),
+            toAtomicAma(input.amount).toString(),
+            input.symbol
+        ]);
+    }
+    /**
+     * Build and sign a transfer transaction (static method)
+     *
+     * @param input - Transfer transaction parameters
+     * @returns Transaction hash and packed transaction
+     *
+     * @example
+     * ```ts
+     * const { txHash, txPacked } = TransactionBuilder.buildSignedTransfer({
+     *   senderPrivkey: '5Kd3N...',
+     *   recipient: '5Kd3N...',
+     *   amount: 10.5,
+     *   symbol: 'AMA'
+     * })
+     * ```
+     */
+    static buildSignedTransfer(input) {
+        const { seed64, sk } = deriveSkAndSeed64FromBase58Seed(input.senderPrivkey);
+        const signerPubKey = getPublicKey(seed64);
+        return TransactionBuilder.buildAndSignTransaction(signerPubKey, sk, 'Coin', 'transfer', [
+            fromBase58(input.recipient),
+            toAtomicAma(input.amount).toString(),
+            input.symbol
+        ]);
+    }
+    /**
+     * Build an unsigned transaction (static method)
+     *
+     * @param signerPk - Signer's public key
+     * @param contract - Contract name
+     * @param method - Method name
+     * @param args - Method arguments
+     * @returns Unsigned transaction with hash
+     *
+     * @example
+     * ```ts
+     * const unsignedTx = TransactionBuilder.build(
+     *   publicKey,
+     *   'Coin',
+     *   'transfer',
+     *   [recipientBytes, amount, 'AMA']
+     * )
+     * ```
+     */
+    static build(signerPk, contract, method, args) {
+        return TransactionBuilder.buildUnsignedTransaction(signerPk, contract, method, args);
+    }
+    /**
+     * Sign an unsigned transaction (static method)
+     *
+     * @param unsignedTx - Unsigned transaction with hash
+     * @param signerSk - Signer's secret key
+     * @returns Transaction hash and packed transaction
+     *
+     * @example
+     * ```ts
+     * const unsignedTx = TransactionBuilder.build(publicKey, 'Coin', 'transfer', args)
+     * const { txHash, txPacked } = TransactionBuilder.sign(unsignedTx, secretKey)
+     * ```
+     */
+    static sign(unsignedTx, signerSk) {
+        return TransactionBuilder.signTransaction(unsignedTx, signerSk);
+    }
+    /**
+     * Build and sign a generic transaction (static method)
+     *
+     * @param signerPk - Signer's public key
+     * @param signerSk - Signer's secret key
+     * @param contract - Contract name
+     * @param method - Method name
+     * @param args - Method arguments
+     * @returns Transaction hash and packed transaction
+     *
+     * @example
+     * ```ts
+     * const { txHash, txPacked } = TransactionBuilder.buildAndSign(
+     *   publicKey,
+     *   secretKey,
+     *   'Coin',
+     *   'transfer',
+     *   [recipientBytes, amount, 'AMA']
+     * )
+     * ```
+     */
+    static buildAndSign(signerPk, signerSk, contract, method, args) {
+        return TransactionBuilder.buildAndSignTransaction(signerPk, signerSk, contract, method, args);
+    }
+}
+//# sourceMappingURL=transaction-builder.js.map

package/dist/transaction-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-builder.js","sourceRoot":"","sources":["../src/transaction-builder.ts"],"names":[],"mappings":"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"}