@amadeus-protocol/sdk 1.0.8 → 1.1.0

package/dist/signing.js

@@ -1,84 +1,84 @@
-/**
- * Transaction Signing Primitives
- *
- * Stateless, standalone functions for building and signing Amadeus transactions.
- * This module is the source of truth for the signing pipeline — both
- * TransactionBuilder and createContract().connect() delegate to these functions.
- */
-import { bls12_381 as bls } from '@noble/curves/bls12-381';
-import { sha256 } from '@noble/hashes/sha2';
-import { deriveSkAndSeed64FromBase58Seed, getPublicKey } from './crypto';
-import { toBase58 } from './encoding';
-import { encode } from './serialization';
+import { encode } from "./serialization.js";
+import { toBase58 } from "./encoding.js";
+import { deriveSkAndSeed64FromBase58Seed, getPublicKey } from "./crypto.js";
+import { bls12_381 } from "@noble/curves/bls12-381";
+import { sha256 } from "@noble/hashes/sha2";
+//#region src/signing.ts
 /** Domain Separation Tag for transaction signatures */
-const TX_DST = 'AMADEUS_SIG_BLS12381G2_XMD:SHA-256_SSWU_RO_TX_';
+const TX_DST = "AMADEUS_SIG_BLS12381G2_XMD:SHA-256_SSWU_RO_TX_";
 /** Generate a transaction nonce based on current timestamp */
 function generateNonce() {
-    return BigInt(Date.now()) * 1000000n;
+	return BigInt(Date.now()) * 1000000n;
 }
 /**
- * Normalize a signer secret key to PrivKey format.
- * Accepts Base58 strings, raw Uint8Array, or already-derived PrivKey.
- */
-export function normalizeSignerSk(signerSk) {
-    if (typeof signerSk === 'string') {
-        const { sk } = deriveSkAndSeed64FromBase58Seed(signerSk);
-        return sk;
-    }
-    return signerSk;
+* Normalize a signer secret key to PrivKey format.
+* Accepts Base58 strings, raw Uint8Array, or already-derived PrivKey.
+*/
+function normalizeSignerSk(signerSk) {
+	if (typeof signerSk === "string") {
+		const { sk } = deriveSkAndSeed64FromBase58Seed(signerSk);
+		return sk;
+	}
+	return signerSk;
 }
 /**
- * Build an unsigned transaction from raw contract/method/args.
- */
-export function buildUnsigned(signerPk, contract, method, args) {
-    const action = {
-        op: 'call',
-        contract,
-        function: method,
-        args
-    };
-    const tx = {
-        signer: signerPk,
-        nonce: generateNonce(),
-        action
-    };
-    const txEncoded = encode(tx);
-    const hash = sha256(txEncoded);
-    return { tx, hash };
+* Build an unsigned transaction from raw contract/method/args.
+*/
+function buildUnsigned(signerPk, contract, method, args) {
+	const action = {
+		op: "call",
+		contract,
+		function: method,
+		args
+	};
+	const tx = {
+		signer: signerPk,
+		nonce: generateNonce(),
+		action
+	};
+	return {
+		tx,
+		hash: sha256(encode(tx))
+	};
 }
 /**
- * Sign an already-built unsigned transaction.
- */
-export function signUnsigned(unsignedTx, signerSk) {
-    const sk = normalizeSignerSk(signerSk);
-    const signature = bls.sign(unsignedTx.hash, sk, { DST: TX_DST });
-    return {
-        txHash: toBase58(unsignedTx.hash),
-        txPacked: encode({ tx: unsignedTx.tx, hash: unsignedTx.hash, signature })
-    };
+* Sign an already-built unsigned transaction.
+*/
+function signUnsigned(unsignedTx, signerSk) {
+	const sk = normalizeSignerSk(signerSk);
+	const signature = bls12_381.sign(unsignedTx.hash, sk, { DST: TX_DST });
+	return {
+		txHash: toBase58(unsignedTx.hash),
+		txPacked: encode({
+			tx: unsignedTx.tx,
+			hash: unsignedTx.hash,
+			signature
+		})
+	};
 }
 /**
- * Build and sign a transaction from raw contract/method/args.
- */
-export function buildAndSignRaw(signerPk, signerSk, contract, method, args) {
-    const unsignedTx = buildUnsigned(signerPk, contract, method, args);
-    return signUnsigned(unsignedTx, signerSk);
+* Build and sign a transaction from raw contract/method/args.
+*/
+function buildAndSignRaw(signerPk, signerSk, contract, method, args) {
+	return signUnsigned(buildUnsigned(signerPk, contract, method, args), signerSk);
 }
 /**
- * Build an unsigned transaction from a ContractCall.
- */
-export function buildUnsignedFromCall(signerPk, call) {
-    return buildUnsigned(signerPk, call.contract, call.method, call.args);
+* Build an unsigned transaction from a ContractCall.
+*/
+function buildUnsignedFromCall(signerPk, call) {
+	return buildUnsigned(signerPk, call.contract, call.method, call.args);
 }
 /**
- * Highest-level: derive keys from a Base58 private key and sign a ContractCall.
- *
- * This is the core function behind `TransactionBuilder.signCall()` and
- * `createContract(ABI).connect(key).method()`.
- */
-export function signContractCall(senderPrivkey, call) {
-    const { seed64, sk } = deriveSkAndSeed64FromBase58Seed(senderPrivkey);
-    const signerPubKey = getPublicKey(seed64);
-    return buildAndSignRaw(signerPubKey, sk, call.contract, call.method, call.args);
+* Highest-level: derive keys from a Base58 private key and sign a ContractCall.
+*
+* This is the core function behind `TransactionBuilder.signCall()` and
+* `createContract(ABI).connect(key).method()`.
+*/
+function signContractCall(senderPrivkey, call) {
+	const { seed64, sk } = deriveSkAndSeed64FromBase58Seed(senderPrivkey);
+	return buildAndSignRaw(getPublicKey(seed64), sk, call.contract, call.method, call.args);
 }
+//#endregion
+export { buildAndSignRaw, buildUnsigned, buildUnsignedFromCall, normalizeSignerSk, signContractCall, signUnsigned };
+
 //# sourceMappingURL=signing.js.map

package/dist/signing.js.map

@@ -1 +1 @@
-{"version":3,"file":"signing.js","sourceRoot":"","sources":["../src/signing.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"signing.js","names":["bls"],"sources":["../src/signing.ts"],"sourcesContent":["/**\n * Transaction Signing Primitives\n *\n * Stateless, standalone functions for building and signing Amadeus transactions.\n * This module is the source of truth for the signing pipeline — both\n * TransactionBuilder and createContract().connect() delegate to these functions.\n */\n\nimport type { PrivKey } from '@noble/curves/abstract/utils'\nimport { bls12_381 as bls } from '@noble/curves/bls12-381'\nimport { sha256 } from '@noble/hashes/sha2'\n\nimport { deriveSkAndSeed64FromBase58Seed, getPublicKey } from './crypto'\nimport { toBase58 } from './encoding'\nimport { encode } from './serialization'\nimport type {\n\tBuildTransactionResult,\n\tSerializableValue,\n\tTransactionAction,\n\tUnsignedTransaction,\n\tUnsignedTransactionWithHash\n} from './types'\nimport type { ContractCall } from './contracts/contract-call'\n\n/** Domain Separation Tag for transaction signatures */\nconst TX_DST = 'AMADEUS_SIG_BLS12381G2_XMD:SHA-256_SSWU_RO_TX_'\n\n/** Generate a transaction nonce based on current timestamp */\nfunction generateNonce(): bigint {\n\treturn BigInt(Date.now()) * 1_000_000n\n}\n\n/**\n * Normalize a signer secret key to PrivKey format.\n * Accepts Base58 strings, raw Uint8Array, or already-derived PrivKey.\n */\nexport function normalizeSignerSk(signerSk: PrivKey | string | Uint8Array): PrivKey {\n\tif (typeof signerSk === 'string') {\n\t\tconst { sk } = deriveSkAndSeed64FromBase58Seed(signerSk)\n\t\treturn sk\n\t}\n\treturn signerSk\n}\n\n/**\n * Build an unsigned transaction from raw contract/method/args.\n */\nexport function buildUnsigned(\n\tsignerPk: Uint8Array,\n\tcontract: string,\n\tmethod: string,\n\targs: SerializableValue[]\n): UnsignedTransactionWithHash {\n\tconst action: TransactionAction = {\n\t\top: 'call',\n\t\tcontract,\n\t\tfunction: method,\n\t\targs\n\t}\n\tconst tx: UnsignedTransaction = {\n\t\tsigner: signerPk,\n\t\tnonce: generateNonce(),\n\t\taction\n\t}\n\tconst txEncoded = encode(tx)\n\tconst hash = sha256(txEncoded)\n\treturn { tx, hash }\n}\n\n/**\n * Sign an already-built unsigned transaction.\n */\nexport function signUnsigned(\n\tunsignedTx: UnsignedTransactionWithHash,\n\tsignerSk: PrivKey | string | Uint8Array\n): BuildTransactionResult {\n\tconst sk = normalizeSignerSk(signerSk)\n\tconst signature = bls.sign(unsignedTx.hash, sk, { DST: TX_DST })\n\treturn {\n\t\ttxHash: toBase58(unsignedTx.hash),\n\t\ttxPacked: encode({ tx: unsignedTx.tx, hash: unsignedTx.hash, signature })\n\t}\n}\n\n/**\n * Build and sign a transaction from raw contract/method/args.\n */\nexport function buildAndSignRaw(\n\tsignerPk: Uint8Array,\n\tsignerSk: PrivKey | string | Uint8Array,\n\tcontract: string,\n\tmethod: string,\n\targs: SerializableValue[]\n): BuildTransactionResult {\n\tconst unsignedTx = buildUnsigned(signerPk, contract, method, args)\n\treturn signUnsigned(unsignedTx, signerSk)\n}\n\n/**\n * Build an unsigned transaction from a ContractCall.\n */\nexport function buildUnsignedFromCall(\n\tsignerPk: Uint8Array,\n\tcall: ContractCall\n): UnsignedTransactionWithHash {\n\treturn buildUnsigned(signerPk, call.contract, call.method, call.args)\n}\n\n/**\n * Highest-level: derive keys from a Base58 private key and sign a ContractCall.\n *\n * This is the core function behind `TransactionBuilder.signCall()` and\n * `createContract(ABI).connect(key).method()`.\n */\nexport function signContractCall(\n\tsenderPrivkey: string,\n\tcall: ContractCall\n): BuildTransactionResult {\n\tconst { seed64, sk } = deriveSkAndSeed64FromBase58Seed(senderPrivkey)\n\tconst signerPubKey = getPublicKey(seed64)\n\treturn buildAndSignRaw(signerPubKey, sk, call.contract, call.method, call.args)\n}\n"],"mappings":";;;;;;;AAyBA,MAAM,SAAS;;AAGf,SAAS,gBAAwB;CAChC,OAAO,OAAO,KAAK,KAAK,CAAC,GAAG;;;;;;AAO7B,SAAgB,kBAAkB,UAAkD;CACnF,IAAI,OAAO,aAAa,UAAU;EACjC,MAAM,EAAE,OAAO,gCAAgC,SAAS;EACxD,OAAO;;CAER,OAAO;;;;;AAMR,SAAgB,cACf,UACA,UACA,QACA,MAC8B;CAC9B,MAAM,SAA4B;EACjC,IAAI;EACJ;EACA,UAAU;EACV;EACA;CACD,MAAM,KAA0B;EAC/B,QAAQ;EACR,OAAO,eAAe;EACtB;EACA;CAGD,OAAO;EAAE;EAAI,MADA,OADK,OAAO,GACI,CACZ;EAAE;;;;;AAMpB,SAAgB,aACf,YACA,UACyB;CACzB,MAAM,KAAK,kBAAkB,SAAS;CACtC,MAAM,YAAYA,UAAI,KAAK,WAAW,MAAM,IAAI,EAAE,KAAK,QAAQ,CAAC;CAChE,OAAO;EACN,QAAQ,SAAS,WAAW,KAAK;EACjC,UAAU,OAAO;GAAE,IAAI,WAAW;GAAI,MAAM,WAAW;GAAM;GAAW,CAAC;EACzE;;;;;AAMF,SAAgB,gBACf,UACA,UACA,UACA,QACA,MACyB;CAEzB,OAAO,aADY,cAAc,UAAU,UAAU,QAAQ,KAC/B,EAAE,SAAS;;;;;AAM1C,SAAgB,sBACf,UACA,MAC8B;CAC9B,OAAO,cAAc,UAAU,KAAK,UAAU,KAAK,QAAQ,KAAK,KAAK;;;;;;;;AAStE,SAAgB,iBACf,eACA,MACyB;CACzB,MAAM,EAAE,QAAQ,OAAO,gCAAgC,cAAc;CAErE,OAAO,gBADc,aAAa,OACC,EAAE,IAAI,KAAK,UAAU,KAAK,QAAQ,KAAK,KAAK"}

package/dist/transaction-builder.d.ts

@@ -1,34 +1,11 @@
-/**
- * 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 type { PrivKey } from '@noble/curves/abstract/utils';
-import type { BuildTransactionResult, LockupPrimeDailyCheckinInput, LockupPrimeLockInput, LockupPrimeUnlockInput, LockupUnlockInput, SerializableValue, TransferTransactionInput, UnsignedTransactionWithHash } from './types';
-import type { AbiDefinition } from './contracts/abi-types';
-import type { ContractCall } from './contracts/contract-call';
-import { type SignedContract } from './contracts/contract';
+import { BuildTransactionResult, LockupPrimeDailyCheckinInput, LockupPrimeLockInput, LockupPrimeUnlockInput, LockupUnlockInput, SerializableValue, TransferTransactionInput, UnsignedTransactionWithHash } from "./types.js";
+import { AbiDefinition } from "./contracts/abi-types.js";
+import { ContractCall } from "./contracts/contract-call.js";
+import { SignedContract } from "./contracts/contract.js";
+import { NftCreateCollectionInput, NftCreateCollectionParams, NftMintInput, NftMintParams, NftTransferInput, NftTransferParams } from "./contracts/nft/types.js";
+import { PrivKey } from "@noble/curves/abstract/utils";
+
+//#region src/transaction-builder.d.ts
 /**
  * Transaction Builder for Amadeus Protocol
  *
@@ -51,158 +28,172 @@ import { type SignedContract } from './contracts/contract';
  * ])
  * ```
  */
-export declare class TransactionBuilder {
-    private readonly privateKey;
-    private signerPk;
-    private signerSk;
-    /**
-     * 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);
-    /**
-     * Initialize signer keys from the private key
-     */
-    private initializeKeys;
-    /**
-     * Get the signer's secret key (normalizes to PrivKey format)
-     */
-    private getSignerSk;
-    private requirePk;
-    /**
-     * 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<TAbi extends AbiDefinition>(abi: TAbi): SignedContract<TAbi>;
-    /**
-     * 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: string, call: ContractCall): BuildTransactionResult;
-    /**
-     * Build an unsigned transaction from a ContractCall (static)
-     */
-    static buildFromCall(call: ContractCall, signerPk: Uint8Array): UnsignedTransactionWithHash;
-    /**
-     * Build and sign a transaction from a ContractCall (static)
-     */
-    static buildAndSignCall(signerPk: Uint8Array, signerSk: PrivKey | string | Uint8Array, call: ContractCall): BuildTransactionResult;
-    /**
-     * Build an unsigned transaction from a ContractCall (instance)
-     */
-    buildFromCall(call: ContractCall): UnsignedTransactionWithHash;
-    /**
-     * Build and sign a transaction from a ContractCall (instance)
-     */
-    buildAndSignCall(call: ContractCall): BuildTransactionResult;
-    /**
-     * Build an unsigned transaction (instance)
-     */
-    build(contract: string, method: string, args: SerializableValue[], signerPk?: Uint8Array): UnsignedTransactionWithHash;
-    /**
-     * Sign an unsigned transaction (instance)
-     */
-    sign(unsignedTx: UnsignedTransactionWithHash, signerSk?: PrivKey | string | Uint8Array): BuildTransactionResult;
-    /**
-     * Build and sign a generic transaction (instance)
-     */
-    buildAndSign(contract: string, method: string, args: SerializableValue[], signerPk?: Uint8Array, signerSk?: PrivKey | string | Uint8Array): BuildTransactionResult;
-    /**
-     * Build an unsigned transaction (static)
-     */
-    static build(signerPk: Uint8Array, contract: string, method: string, args: SerializableValue[]): UnsignedTransactionWithHash;
-    /**
-     * Sign an unsigned transaction (static)
-     */
-    static sign(unsignedTx: UnsignedTransactionWithHash, signerSk: PrivKey | string | Uint8Array): BuildTransactionResult;
-    /**
-     * Build and sign a generic transaction (static)
-     */
-    static buildAndSign(signerPk: Uint8Array, signerSk: PrivKey | string | Uint8Array, contract: string, method: string, args: SerializableValue[]): BuildTransactionResult;
-    /**
-     * Build an unsigned Coin transfer transaction
-     */
-    buildTransfer(input: Omit<TransferTransactionInput, 'senderPrivkey'>): UnsignedTransactionWithHash;
-    /**
-     * Build and sign a Coin transfer transaction
-     */
-    transfer(input: Omit<TransferTransactionInput, 'senderPrivkey'>): BuildTransactionResult;
-    /**
-     * Build an unsigned Coin transfer transaction (static)
-     */
-    static buildTransfer(input: Omit<TransferTransactionInput, 'senderPrivkey'>, signerPk: Uint8Array): UnsignedTransactionWithHash;
-    /**
-     * Build and sign a Coin transfer transaction (static)
-     */
-    static buildSignedTransfer(input: TransferTransactionInput): BuildTransactionResult;
-    /**
-     * Build and sign a LockupPrime lock transaction
-     */
-    lockupPrimeLock(input: Omit<LockupPrimeLockInput, 'senderPrivkey'>): BuildTransactionResult;
-    /**
-     * Build and sign a LockupPrime unlock transaction
-     */
-    lockupPrimeUnlock(input: Omit<LockupPrimeUnlockInput, 'senderPrivkey'>): BuildTransactionResult;
-    /**
-     * Build and sign a LockupPrime daily check-in transaction
-     */
-    lockupPrimeDailyCheckin(input: Omit<LockupPrimeDailyCheckinInput, 'senderPrivkey'>): BuildTransactionResult;
-    /**
-     * Build and sign a Lockup unlock transaction
-     */
-    lockupUnlock(input: Omit<LockupUnlockInput, 'senderPrivkey'>): BuildTransactionResult;
-    /**
-     * Build and sign a LockupPrime lock transaction (static)
-     */
-    static buildSignedLockupPrimeLock(input: LockupPrimeLockInput): BuildTransactionResult;
-    /**
-     * Build and sign a LockupPrime unlock transaction (static)
-     */
-    static buildSignedLockupPrimeUnlock(input: LockupPrimeUnlockInput): BuildTransactionResult;
-    /**
-     * Build and sign a LockupPrime daily check-in transaction (static)
-     */
-    static buildSignedLockupPrimeDailyCheckin(input: LockupPrimeDailyCheckinInput): BuildTransactionResult;
-    /**
-     * Build and sign a Lockup unlock transaction (static)
-     */
-    static buildSignedLockupUnlock(input: LockupUnlockInput): BuildTransactionResult;
+declare class TransactionBuilder {
+  private readonly privateKey;
+  private signerPk;
+  private signerSk;
+  /**
+   * 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);
+  /**
+   * Initialize signer keys from the private key
+   */
+  private initializeKeys;
+  /**
+   * Get the signer's secret key (normalizes to PrivKey format)
+   */
+  private getSignerSk;
+  private requirePk;
+  /**
+   * 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<TAbi extends AbiDefinition>(abi: TAbi): SignedContract<TAbi>;
+  /**
+   * 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: string, call: ContractCall): BuildTransactionResult;
+  /**
+   * Build an unsigned transaction from a ContractCall (static)
+   */
+  static buildFromCall(call: ContractCall, signerPk: Uint8Array): UnsignedTransactionWithHash;
+  /**
+   * Build and sign a transaction from a ContractCall (static)
+   */
+  static buildAndSignCall(signerPk: Uint8Array, signerSk: PrivKey | string | Uint8Array, call: ContractCall): BuildTransactionResult;
+  /**
+   * Build an unsigned transaction from a ContractCall (instance)
+   */
+  buildFromCall(call: ContractCall): UnsignedTransactionWithHash;
+  /**
+   * Build and sign a transaction from a ContractCall (instance)
+   */
+  buildAndSignCall(call: ContractCall): BuildTransactionResult;
+  /**
+   * Build an unsigned transaction (instance)
+   */
+  build(contract: string, method: string, args: SerializableValue[], signerPk?: Uint8Array): UnsignedTransactionWithHash;
+  /**
+   * Sign an unsigned transaction (instance)
+   */
+  sign(unsignedTx: UnsignedTransactionWithHash, signerSk?: PrivKey | string | Uint8Array): BuildTransactionResult;
+  /**
+   * Build and sign a generic transaction (instance)
+   */
+  buildAndSign(contract: string, method: string, args: SerializableValue[], signerPk?: Uint8Array, signerSk?: PrivKey | string | Uint8Array): BuildTransactionResult;
+  /**
+   * Build an unsigned transaction (static)
+   */
+  static build(signerPk: Uint8Array, contract: string, method: string, args: SerializableValue[]): UnsignedTransactionWithHash;
+  /**
+   * Sign an unsigned transaction (static)
+   */
+  static sign(unsignedTx: UnsignedTransactionWithHash, signerSk: PrivKey | string | Uint8Array): BuildTransactionResult;
+  /**
+   * Build and sign a generic transaction (static)
+   */
+  static buildAndSign(signerPk: Uint8Array, signerSk: PrivKey | string | Uint8Array, contract: string, method: string, args: SerializableValue[]): BuildTransactionResult;
+  /**
+   * Build an unsigned Coin transfer transaction
+   */
+  buildTransfer(input: Omit<TransferTransactionInput, 'senderPrivkey'>): UnsignedTransactionWithHash;
+  /**
+   * Build and sign a Coin transfer transaction
+   */
+  transfer(input: Omit<TransferTransactionInput, 'senderPrivkey'>): BuildTransactionResult;
+  /**
+   * Build an unsigned Coin transfer transaction (static)
+   */
+  static buildTransfer(input: Omit<TransferTransactionInput, 'senderPrivkey'>, signerPk: Uint8Array): UnsignedTransactionWithHash;
+  /**
+   * Build and sign a Coin transfer transaction (static)
+   */
+  static buildSignedTransfer(input: TransferTransactionInput): BuildTransactionResult;
+  /**
+   * Build and sign a LockupPrime lock transaction
+   */
+  lockupPrimeLock(input: Omit<LockupPrimeLockInput, 'senderPrivkey'>): BuildTransactionResult;
+  /**
+   * Build and sign a LockupPrime unlock transaction
+   */
+  lockupPrimeUnlock(input: Omit<LockupPrimeUnlockInput, 'senderPrivkey'>): BuildTransactionResult;
+  /**
+   * Build and sign a LockupPrime daily check-in transaction
+   */
+  lockupPrimeDailyCheckin(input: Omit<LockupPrimeDailyCheckinInput, 'senderPrivkey'>): BuildTransactionResult;
+  /**
+   * Build and sign a Lockup unlock transaction
+   */
+  lockupUnlock(input: Omit<LockupUnlockInput, 'senderPrivkey'>): BuildTransactionResult;
+  /**
+   * Build and sign a LockupPrime lock transaction (static)
+   */
+  static buildSignedLockupPrimeLock(input: LockupPrimeLockInput): BuildTransactionResult;
+  /**
+   * Build and sign a LockupPrime unlock transaction (static)
+   */
+  static buildSignedLockupPrimeUnlock(input: LockupPrimeUnlockInput): BuildTransactionResult;
+  /**
+   * Build and sign a LockupPrime daily check-in transaction (static)
+   */
+  static buildSignedLockupPrimeDailyCheckin(input: LockupPrimeDailyCheckinInput): BuildTransactionResult;
+  /**
+   * Build and sign a Lockup unlock transaction (static)
+   */
+  static buildSignedLockupUnlock(input: LockupUnlockInput): BuildTransactionResult;
+  /** Build and sign an `Nft.transfer` transaction */
+  nftTransfer(input: NftTransferParams): BuildTransactionResult;
+  /** Build and sign an `Nft.mint` transaction (collection owner only) */
+  nftMint(input: NftMintParams): BuildTransactionResult;
+  /** Build and sign an `Nft.create_collection` transaction */
+  nftCreateCollection(input: NftCreateCollectionParams): BuildTransactionResult;
+  /** Build and sign an `Nft.transfer` transaction (static) */
+  static buildSignedNftTransfer(input: NftTransferInput): BuildTransactionResult;
+  /** Build and sign an `Nft.mint` transaction (static) */
+  static buildSignedNftMint(input: NftMintInput): BuildTransactionResult;
+  /** Build and sign an `Nft.create_collection` transaction (static) */
+  static buildSignedNftCreateCollection(input: NftCreateCollectionInput): BuildTransactionResult;
 }
+//#endregion
+export { TransactionBuilder };
 //# sourceMappingURL=transaction-builder.d.ts.map

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

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