@chainvue/verus-sdk 0.13.0 → 0.14.0

package/dist/currency/definition.d.ts

@@ -0,0 +1,181 @@
+/**
+ * Offline serialization of a Verus currency definition (`CCurrencyDefinition`)
+ * into the `EVAL_CURRENCY_DEFINITION` CryptoCondition output script that a
+ * `definecurrency` transaction carries.
+ *
+ * This is a serialization primitive: it builds (and lets you inspect/verify) the
+ * definition output script byte-for-byte as the daemon would. It is NOT a
+ * currency launcher — a valid definition transaction also carries currency-state
+ * and notarization outputs validated against live chain state, so the actual
+ * launch is a daemon (`definecurrency`) operation, not an offline one.
+ *
+ * Scope: simple tokens (`OPTION_TOKEN`) and fractional reserve baskets
+ * (`OPTION_TOKEN | OPTION_FRACTIONAL`). PBaaS chains and gateways are rejected
+ * fail-closed — their serialization carries extra trailing fields (launch fees,
+ * issuance schedule, gateway converter) that this builder deliberately omits.
+ *
+ * The byte layout mirrors `CCurrencyDefinition::SerializationOp`
+ * (VerusCoin `src/pbaas/crosschainrpc.h`). A subtlety load-bearing for
+ * correctness: for a non-gateway, non-PBaaS currency the C++ `else` branch
+ * writes the five trailing fee fields (`currencyRegistrationFee` …
+ * `transactionExportFee`) into a *shadowed local stream*, so they never reach
+ * the wire — a token/basket definition ends at `idImportFees`. This is
+ * reproduced here and byte-locked against real on-chain definitions
+ * (see test/currency-definition.test.ts) rather than trusted from the header.
+ *
+ * The CC wrapper (OptCCParams master eval 0 + params eval 2, both m=1/n=1 to a
+ * single pubkey destination) sends to the daemon's hardcoded currency-definition
+ * pubkey (`CCcustom.cpp` `PBaaSDefinitionPubKey`), which is chain-independent.
+ */
+/** Currency-definition data-structure version (`CCurrencyDefinition::VERSION_CURRENT`). */
+export declare const CURRENCY_DEFINITION_VERSION = 1;
+/** Currency option bits (`CCurrencyDefinition::ECurrencyOptions`). */
+export declare const CURRENCY_OPTION: {
+    readonly FRACTIONAL: 1;
+    readonly ID_RESTRICTED: 2;
+    readonly ID_STAKING: 4;
+    readonly ID_REFERRALS: 8;
+    readonly ID_REFERRALREQUIRED: 16;
+    readonly TOKEN: 32;
+    readonly SINGLECURRENCY: 64;
+    readonly GATEWAY: 128;
+    readonly PBAAS: 256;
+    readonly GATEWAY_CONVERTER: 512;
+    readonly GATEWAY_NAMECONTROLLER: 1024;
+    readonly NFT_TOKEN: 2048;
+    readonly NO_IDS: 4096;
+};
+/** Notarization protocol (`ENotarizationProtocol`). */
+export declare const NOTARIZATION_PROTOCOL: {
+    readonly AUTO: 1;
+    readonly NOTARY_CONFIRM: 2;
+    readonly NOTARY_CHAINID: 3;
+};
+/** Proof protocol (`EProofProtocol`). */
+export declare const PROOF_PROTOCOL: {
+    readonly PBAASMMR: 1;
+    readonly CHAINID: 2;
+    readonly ETHNOTARIZATION: 3;
+};
+/**
+ * A currency to define. Amounts are bigint satoshis (never `number`). Reserve
+ * currencies and pre-allocation recipients are given as i-addresses.
+ */
+export interface CurrencyDefinitionInput {
+    /** Bare currency name, matching the identity it is defined under (no `@`). */
+    name: string;
+    /** Parent namespace i-address (the chain/currency this is registered under). */
+    parent: string;
+    /**
+     * Option bits (see {@link CURRENCY_OPTION}). Must include `TOKEN`. `GATEWAY`
+     * and `PBAAS` are rejected — out of scope for this offline builder.
+     */
+    options: number;
+    /** Controlling system i-address. Defaults to `parent`. */
+    systemId?: string;
+    /** Launch system i-address. Defaults to `systemId`. */
+    launchSystemId?: string;
+    /** Notarization protocol. Defaults to `AUTO` (1). */
+    notarizationProtocol?: number;
+    /** Proof protocol. Defaults to `CHAINID` (2) for a centralized token. */
+    proofProtocol?: number;
+    /** Block at which pre-launch ends / the token activates. Defaults to 0. */
+    startBlock?: number;
+    /** End-of-life block, 0 = no end. Defaults to 0. */
+    endBlock?: number;
+    /** Fractional supply available for pre-launch conversion (fractional only). */
+    initialSupply?: bigint;
+    /** Pre-allocation / premine recipients. */
+    preAllocations?: Array<{
+        address: string;
+        amount: bigint;
+    }>;
+    /** Reserve currency i-addresses (fractional basket). */
+    currencies?: string[];
+    /**
+     * Relative reserve weights, one positive int32 ratio per reserve currency.
+     * Normalized to sum to 1e8 exactly as `definecurrency` does (so `[0.4, 0.4]`
+     * expressed as `[40_000_000n, 40_000_000n]` becomes `[50_000_000n,
+     * 50_000_000n]`); pass values already summing to 1e8 for a no-op.
+     */
+    weights?: bigint[];
+    /** Minimum per-reserve to launch (same length as `currencies`). */
+    minPreconversion?: bigint[];
+    /** Maximum per-reserve allowed (same length as `currencies`); each ≥ its minimum. */
+    maxPreconversion?: bigint[];
+    /** Pre-launch discount ratio (fractional < 100%). Defaults to 0. */
+    preLaunchDiscount?: bigint;
+    /** Pre-launch carve-out ratio in satoshis. Defaults to 0. */
+    preLaunchCarveOut?: number;
+    /** ID registration fee in native satoshis. Defaults to 100 native (1e10). */
+    idRegistrationFees?: bigint;
+    /** Referral levels. Defaults to 3. */
+    idReferralLevels?: number;
+    /**
+     * ID import fee in native satoshis. For a fractional currency this is instead
+     * the pricing-currency index into `currencies`. Defaults to 0.02 native.
+     */
+    idImportFees?: bigint;
+}
+/** Fully resolved definition with all defaults applied. */
+export interface NormalizedDefinition {
+    version: number;
+    options: number;
+    parent: string;
+    name: string;
+    launchSystemId: string;
+    systemId: string;
+    notarizationProtocol: number;
+    proofProtocol: number;
+    startBlock: number;
+    endBlock: number;
+    initialFractionalSupply: bigint;
+    preAllocations: Array<{
+        address: string;
+        amount: bigint;
+    }>;
+    gatewayConverterIssuance: bigint;
+    currencies: string[];
+    weights: bigint[];
+    conversions: bigint[];
+    minPreconversion: bigint[];
+    maxPreconversion: bigint[];
+    initialContributions: bigint[];
+    preconverted: bigint[];
+    preLaunchDiscount: bigint;
+    preLaunchCarveOut: number;
+    notaries: string[];
+    minNotariesConfirm: number;
+    idRegistrationFees: bigint;
+    idReferralLevels: number;
+    idImportFees: bigint;
+}
+/**
+ * Apply daemon-like defaults, enforce the token/basket scope, and normalize
+ * reserve weights. Exposed so the currency-launch output builders derive the
+ * notarization currency-state from the exact same normalized weights the
+ * definition output carries — the daemon validates one against the other.
+ */
+export declare function normalizeCurrencyDefinition(input: CurrencyDefinitionInput): NormalizedDefinition;
+/**
+ * Serialize a normalized currency definition to its `AsVector()` bytes — the
+ * blob carried as `vData[0]` of the EVAL_CURRENCY_DEFINITION output. Field order
+ * and encodings mirror `CCurrencyDefinition::SerializationOp` for the
+ * token/basket (non-gateway, non-PBaaS) case.
+ */
+export declare function serializeNormalizedDefinition(def: NormalizedDefinition): Buffer;
+/**
+ * Serialize a currency definition to its `CCurrencyDefinition::AsVector()` bytes.
+ * Exposed mainly for byte-level testing; most callers want
+ * {@link buildCurrencyDefinitionScript}.
+ */
+export declare function serializeCurrencyDefinition(input: CurrencyDefinitionInput): Buffer;
+/**
+ * Build the EVAL_CURRENCY_DEFINITION CryptoCondition output script for a token or
+ * fractional basket, as a hex string — byte-equivalent to the output the daemon's
+ * `definecurrency` produces for the same parameters. For building, inspecting, or
+ * verifying a definition script offline; a full on-chain launch is a daemon
+ * operation (the transaction also needs live-state notarization outputs).
+ */
+export declare function buildCurrencyDefinitionScript(input: CurrencyDefinitionInput): string;
+//# sourceMappingURL=definition.d.ts.map

package/dist/currency/definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../src/currency/definition.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAoBH,2FAA2F;AAC3F,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAE7C,sEAAsE;AACtE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;CAclB,CAAC;AAEX,uDAAuD;AACvD,eAAO,MAAM,qBAAqB;;;;CAA6D,CAAC;AAChG,yCAAyC;AACzC,eAAO,MAAM,cAAc;;;;CAA2D,CAAC;AAYvF;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAC;IACb,gFAAgF;IAChF,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qDAAqD;IACrD,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,yEAAyE;IACzE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,+EAA+E;IAC/E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2CAA2C;IAC3C,cAAc,CAAC,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAE5D,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,mEAAmE;IACnE,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,qFAAqF;IACrF,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE5B,oEAAoE;IACpE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,6DAA6D;IAC7D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,6EAA6E;IAC7E,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,sCAAsC;IACtC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,2DAA2D;AAC3D,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,uBAAuB,EAAE,MAAM,CAAC;IAChC,cAAc,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3D,wBAAwB,EAAE,MAAM,CAAC;IACjC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;CACtB;AAaD;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,uBAAuB,GAAG,oBAAoB,CA6PhG;AAID;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,oBAAoB,GAAG,MAAM,CAwC/E;AAKD;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,uBAAuB,GAAG,MAAM,CAElF;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,uBAAuB,GAAG,MAAM,CAMpF"}

package/dist/currency/definition.js

@@ -0,0 +1,396 @@
+"use strict";
+/**
+ * Offline serialization of a Verus currency definition (`CCurrencyDefinition`)
+ * into the `EVAL_CURRENCY_DEFINITION` CryptoCondition output script that a
+ * `definecurrency` transaction carries.
+ *
+ * This is a serialization primitive: it builds (and lets you inspect/verify) the
+ * definition output script byte-for-byte as the daemon would. It is NOT a
+ * currency launcher — a valid definition transaction also carries currency-state
+ * and notarization outputs validated against live chain state, so the actual
+ * launch is a daemon (`definecurrency`) operation, not an offline one.
+ *
+ * Scope: simple tokens (`OPTION_TOKEN`) and fractional reserve baskets
+ * (`OPTION_TOKEN | OPTION_FRACTIONAL`). PBaaS chains and gateways are rejected
+ * fail-closed — their serialization carries extra trailing fields (launch fees,
+ * issuance schedule, gateway converter) that this builder deliberately omits.
+ *
+ * The byte layout mirrors `CCurrencyDefinition::SerializationOp`
+ * (VerusCoin `src/pbaas/crosschainrpc.h`). A subtlety load-bearing for
+ * correctness: for a non-gateway, non-PBaaS currency the C++ `else` branch
+ * writes the five trailing fee fields (`currencyRegistrationFee` …
+ * `transactionExportFee`) into a *shadowed local stream*, so they never reach
+ * the wire — a token/basket definition ends at `idImportFees`. This is
+ * reproduced here and byte-locked against real on-chain definitions
+ * (see test/currency-definition.test.ts) rather than trusted from the header.
+ *
+ * The CC wrapper (OptCCParams master eval 0 + params eval 2, both m=1/n=1 to a
+ * single pubkey destination) sends to the daemon's hardcoded currency-definition
+ * pubkey (`CCcustom.cpp` `PBaaSDefinitionPubKey`), which is chain-independent.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PROOF_PROTOCOL = exports.NOTARIZATION_PROTOCOL = exports.CURRENCY_OPTION = exports.CURRENCY_DEFINITION_VERSION = void 0;
+exports.normalizeCurrencyDefinition = normalizeCurrencyDefinition;
+exports.serializeNormalizedDefinition = serializeNormalizedDefinition;
+exports.serializeCurrencyDefinition = serializeCurrencyDefinition;
+exports.buildCurrencyDefinitionScript = buildCurrencyDefinitionScript;
+const index_js_1 = require("../utils/index.js");
+const errors_js_1 = require("../errors.js");
+const wire_js_1 = require("./wire.js");
+/** Currency-definition data-structure version (`CCurrencyDefinition::VERSION_CURRENT`). */
+exports.CURRENCY_DEFINITION_VERSION = 1;
+/** Currency option bits (`CCurrencyDefinition::ECurrencyOptions`). */
+exports.CURRENCY_OPTION = {
+    FRACTIONAL: 0x1,
+    ID_RESTRICTED: 0x2,
+    ID_STAKING: 0x4,
+    ID_REFERRALS: 0x8,
+    ID_REFERRALREQUIRED: 0x10,
+    TOKEN: 0x20,
+    SINGLECURRENCY: 0x40,
+    GATEWAY: 0x80,
+    PBAAS: 0x100,
+    GATEWAY_CONVERTER: 0x200,
+    GATEWAY_NAMECONTROLLER: 0x400,
+    NFT_TOKEN: 0x800,
+    NO_IDS: 0x1000,
+};
+/** Notarization protocol (`ENotarizationProtocol`). */
+exports.NOTARIZATION_PROTOCOL = { AUTO: 1, NOTARY_CONFIRM: 2, NOTARY_CHAINID: 3 };
+/** Proof protocol (`EProofProtocol`). */
+exports.PROOF_PROTOCOL = { PBAASMMR: 1, CHAINID: 2, ETHNOTARIZATION: 3 };
+/**
+ * The daemon's hardcoded destination pubkey for EVAL_CURRENCY_DEFINITION outputs
+ * (`src/cc/CCcustom.cpp` `PBaaSDefinitionPubKey`). Chain-independent — identical
+ * on VRSC and VRSCTEST — so it is safe to embed rather than derive.
+ */
+const CURRENCY_DEFINITION_PUBKEY = Buffer.from('02a0de91740d3d5a3a4a7990ae22315133d02f33716b339ebce88662d012224ef5', 'hex');
+const DEFAULT_ID_REGISTRATION_FEE = 10000000000n; // 100 native
+const DEFAULT_ID_IMPORT_FEE = 2000000n; // 0.02 native
+const DEFAULT_ID_REFERRAL_LEVELS = 3;
+// Consensus limits the daemon enforces (VerusCoin v1.2.17-1).
+const MIN_RESERVE_RATIO = 5000000n; // 5% of SATOSHIDEN — the per-reserve weight floor (crosschainrpc.h MIN_RESERVE_RATIO)
+const MAX_RESERVE_CURRENCIES = 10; // pbaasrpc.cpp:13613
+const MAX_ID_REFERRAL_LEVELS = 5; // crosschainrpc.h MAX_ID_REFERRAL_LEVELS
+const MIN_CURRENCY_LIFE = 480; // endBlock must be ≥ startBlock + this (pbaasrpc.cpp:13497)
+const BLOCK_MAX = 0x7fffffff; // startBlock/endBlock are int32 on the wire
+/**
+ * Apply daemon-like defaults, enforce the token/basket scope, and normalize
+ * reserve weights. Exposed so the currency-launch output builders derive the
+ * notarization currency-state from the exact same normalized weights the
+ * definition output carries — the daemon validates one against the other.
+ */
+function normalizeCurrencyDefinition(input) {
+    if (!input.name || input.name.includes('@')) {
+        throw new errors_js_1.TransactionBuildError('name must be a bare currency name without "@"');
+    }
+    if (!Number.isInteger(input.options)) {
+        throw new errors_js_1.TransactionBuildError('options is required (must include the TOKEN bit)');
+    }
+    if (!(input.options & exports.CURRENCY_OPTION.TOKEN)) {
+        throw new errors_js_1.TransactionBuildError('options must include the TOKEN bit (0x20); native currencies are out of scope');
+    }
+    if (input.options & (exports.CURRENCY_OPTION.GATEWAY | exports.CURRENCY_OPTION.PBAAS | exports.CURRENCY_OPTION.GATEWAY_CONVERTER)) {
+        throw new errors_js_1.TransactionBuildError('GATEWAY and PBAAS currencies are out of scope for the offline builder');
+    }
+    if (input.options < 0 || input.options > exports.CURRENCY_OPTION.NO_IDS * 2 - 1) {
+        throw new errors_js_1.TransactionBuildError(`options has bits outside the known mask: ${input.options}`);
+    }
+    // `conversions` and `initialContributions` are deliberately unsupported.
+    // definecurrency ignores an explicit `conversions` for a fractional currency
+    // (it derives prices at launch), and `initialContributions` seeds reserves the
+    // identity must already hold — requiring reserve-deposit inputs this offline
+    // builder does not assemble. Reject rather than silently drop, so a caller
+    // migrating from definecurrency JSON fails loud instead of shipping a
+    // definition the daemon would not have produced.
+    const legacy = input;
+    if (legacy.conversions !== undefined) {
+        throw new errors_js_1.TransactionBuildError('conversions are not supported: a fractional definition always carries a zero conversion vector (the daemon derives launch prices); omit the field');
+    }
+    if (legacy.initialContributions !== undefined) {
+        throw new errors_js_1.TransactionBuildError('initialContributions are out of scope: they seed reserves the identity must hold and require reserve-deposit inputs the offline builder cannot assemble; contribute via a preconvert reserve-transfer instead');
+    }
+    const isFractional = Boolean(input.options & exports.CURRENCY_OPTION.FRACTIONAL);
+    const isNFT = Boolean(input.options & exports.CURRENCY_OPTION.NFT_TOKEN);
+    const currencies = input.currencies ?? [];
+    const systemId = input.systemId ?? input.parent;
+    const launchSystemId = input.launchSystemId ?? systemId;
+    if (isNFT) {
+        // An NFT (tokenized ID control) is a single-satoshi token mapped to the
+        // native currency, NOT a fractional reserve. The daemon
+        // (`crosschainrpc.cpp`) auto-adds the system currency when maxpreconversion
+        // is [0], and the consensus precheck (`pbaas.cpp`) requires exactly 1 satoshi
+        // of pre-allocation with maxPreconvert=[0], and rejects a centralized
+        // (PROOF_CHAINID) proof protocol ("may not also be a centralized currency").
+        // Reproduce that canonical form here rather than making the caller know it.
+        if (isFractional) {
+            throw new errors_js_1.TransactionBuildError('an NFT (NFT_TOKEN) cannot also be FRACTIONAL');
+        }
+        if (currencies.length || input.weights?.length) {
+            throw new errors_js_1.TransactionBuildError('do not set currencies/weights for an NFT — the system currency is added automatically');
+        }
+        if (input.minPreconversion || input.maxPreconversion) {
+            throw new errors_js_1.TransactionBuildError('do not set min/maxPreconversion for an NFT — they are fixed (maxPreconversion=[0])');
+        }
+        if ((input.initialSupply ?? 0n) !== 0n || (input.preLaunchDiscount ?? 0n) !== 0n) {
+            throw new errors_js_1.TransactionBuildError('an NFT takes no initialSupply or preLaunchDiscount — its supply is the single 1-satoshi token');
+        }
+        if ((input.preLaunchCarveOut ?? 0) !== 0) {
+            throw new errors_js_1.TransactionBuildError('an NFT takes no preLaunchCarveOut');
+        }
+        const proofProtocol = input.proofProtocol ?? exports.PROOF_PROTOCOL.PBAASMMR;
+        if (proofProtocol === exports.PROOF_PROTOCOL.CHAINID) {
+            throw new errors_js_1.TransactionBuildError('an NFT may not use a centralized proof protocol (CHAINID/2); use PBAASMMR (1)');
+        }
+        const preAllocations = input.preAllocations ?? [];
+        const preallocTotal = preAllocations.reduce((sum, p) => sum + p.amount, 0n);
+        if (preallocTotal !== 1n) {
+            throw new errors_js_1.TransactionBuildError('an NFT must pre-allocate exactly 1 satoshi — the single indivisible token');
+        }
+        return {
+            version: exports.CURRENCY_DEFINITION_VERSION,
+            options: input.options,
+            parent: input.parent,
+            name: input.name,
+            launchSystemId,
+            systemId,
+            notarizationProtocol: input.notarizationProtocol ?? exports.NOTARIZATION_PROTOCOL.AUTO,
+            proofProtocol,
+            startBlock: input.startBlock ?? 0,
+            endBlock: input.endBlock ?? 0,
+            initialFractionalSupply: 0n,
+            preAllocations,
+            gatewayConverterIssuance: 0n,
+            // The daemon maps the NFT to the native/system currency with a zeroed
+            // conversion and maxPreconvert=[0]; weights stay empty (not fractional).
+            currencies: [systemId],
+            weights: [],
+            conversions: [0n],
+            minPreconversion: [],
+            maxPreconversion: [0n],
+            initialContributions: [0n],
+            preconverted: [0n],
+            preLaunchDiscount: 0n,
+            preLaunchCarveOut: 0,
+            notaries: [],
+            minNotariesConfirm: 0,
+            idRegistrationFees: input.idRegistrationFees ?? DEFAULT_ID_REGISTRATION_FEE,
+            idReferralLevels: input.idReferralLevels ?? DEFAULT_ID_REFERRAL_LEVELS,
+            idImportFees: input.idImportFees ?? DEFAULT_ID_IMPORT_FEE,
+        };
+    }
+    if (isFractional && currencies.length === 0) {
+        throw new errors_js_1.TransactionBuildError('a fractional currency requires at least one reserve currency');
+    }
+    if (!isFractional && currencies.length > 0) {
+        throw new errors_js_1.TransactionBuildError('reserve currencies require the FRACTIONAL bit (0x01)');
+    }
+    let fractionalWeights = [];
+    if (isFractional) {
+        // The daemon requires one weight per reserve and a positive initial supply.
+        // (It even-splits omitted weights, distributing the remainder to the FIRST
+        // currencies — a byte pattern the explicit path here can't reproduce — so
+        // fail closed and require explicit, already-relative weights instead.)
+        if (input.weights === undefined || input.weights.length !== currencies.length) {
+            throw new errors_js_1.TransactionBuildError(`a fractional currency requires one weight per reserve currency (${currencies.length})`);
+        }
+        if ((input.initialSupply ?? 0n) <= 0n) {
+            throw new errors_js_1.TransactionBuildError('a fractional currency requires a positive initialSupply (the daemon rejects zero)');
+        }
+        if (currencies.length > MAX_RESERVE_CURRENCIES) {
+            throw new errors_js_1.TransactionBuildError(`a fractional currency may have at most ${MAX_RESERVE_CURRENCIES} reserve currencies, got ${currencies.length}`);
+        }
+        // The chain's native currency must be among the reserves (pbaas.cpp:4103,
+        // pbaasrpc.cpp:13694 "Fractional currency requires a reserve of VRSC…").
+        if (!currencies.includes(systemId)) {
+            throw new errors_js_1.TransactionBuildError(`a fractional currency must include the chain's native currency (${systemId}) among its reserves`);
+        }
+        fractionalWeights = (0, wire_js_1.normalizeWeights)(input.weights);
+        // Every reserve must weigh at least 5% (crosschainrpc.h MIN_RESERVE_RATIO).
+        // NOTE: pre-launch carve-out, discount, and pre-allocation emission dilute
+        // weights further AT LAUNCH — this only checks the definition; keep headroom.
+        fractionalWeights.forEach((w, i) => {
+            if (w < MIN_RESERVE_RATIO) {
+                throw new errors_js_1.TransactionBuildError(`reserve weight[${i}] normalizes to ${w}, below the 5% minimum (${MIN_RESERVE_RATIO}); a fractional reserve may not go below 5%`);
+            }
+        });
+    }
+    else {
+        // A non-fractional token has no reserve pool: the daemon reads initialSupply
+        // and preLaunchDiscount only for fractional currencies, so accepting them
+        // would serialize a definition `definecurrency` never emits (rejected at
+        // broadcast). Fail closed, mirroring the `conversions` rejection above.
+        if (input.initialSupply !== undefined && input.initialSupply !== 0n) {
+            throw new errors_js_1.TransactionBuildError('initialSupply applies only to a FRACTIONAL currency');
+        }
+        if (input.preLaunchDiscount !== undefined && input.preLaunchDiscount !== 0n) {
+            throw new errors_js_1.TransactionBuildError('preLaunchDiscount applies only to a FRACTIONAL currency');
+        }
+    }
+    // Scalar-range checks the daemon enforces (crosschainrpc.cpp): block heights are
+    // non-negative integers, carve-out is non-negative, and every pre-allocation is
+    // a positive amount. Catch them here rather than serialize an unbroadcastable tx.
+    const requireBlock = (v, label) => {
+        if (!Number.isInteger(v) || v < 0 || v > BLOCK_MAX) {
+            throw new errors_js_1.TransactionBuildError(`${label} must be an integer block height in [0, ${BLOCK_MAX}], got ${v}`);
+        }
+    };
+    const startBlock = input.startBlock ?? 0;
+    const endBlock = input.endBlock ?? 0;
+    requireBlock(startBlock, 'startBlock');
+    requireBlock(endBlock, 'endBlock');
+    // A currency with an end block must live at least MIN_CURRENCY_LIFE blocks
+    // (pbaasrpc.cpp:13497); endBlock 0 means "no end".
+    if (endBlock !== 0 && endBlock < startBlock + MIN_CURRENCY_LIFE) {
+        throw new errors_js_1.TransactionBuildError(`endBlock (${endBlock}) must be 0 or ≥ startBlock + ${MIN_CURRENCY_LIFE} (${startBlock + MIN_CURRENCY_LIFE})`);
+    }
+    if ((input.idReferralLevels ?? DEFAULT_ID_REFERRAL_LEVELS) > MAX_ID_REFERRAL_LEVELS) {
+        throw new errors_js_1.TransactionBuildError(`idReferralLevels must be ≤ ${MAX_ID_REFERRAL_LEVELS}`);
+    }
+    if ((input.preLaunchCarveOut ?? 0) < 0) {
+        throw new errors_js_1.TransactionBuildError('preLaunchCarveOut must be non-negative');
+    }
+    (input.preAllocations ?? []).forEach((p, i) => {
+        if (p.amount <= 0n) {
+            throw new errors_js_1.TransactionBuildError(`preAllocations[${i}].amount must be positive, got ${p.amount}`);
+        }
+    });
+    // Reserve-currency vectors, when present, must all match the currency count and
+    // hold non-negative amounts (the daemon rejects negatives). The daemon leaves
+    // min/max-preconversion empty when unspecified but zero-fills conversions /
+    // contributions / preconverted to the currency count; mirror that so an omitted
+    // field serializes identically to what `definecurrency` produces.
+    const checkVec = (arr, label) => {
+        if (arr.length !== currencies.length) {
+            throw new errors_js_1.TransactionBuildError(`${label} must have one entry per reserve currency (${currencies.length}), got ${arr.length}`);
+        }
+        arr.forEach((v, i) => {
+            if (v < 0n)
+                throw new errors_js_1.TransactionBuildError(`${label}[${i}] must be non-negative, got ${v}`);
+        });
+        return arr;
+    };
+    const emptyOr = (arr, label) => arr === undefined ? [] : checkVec(arr, label);
+    const zeros = () => new Array(currencies.length).fill(0n);
+    const minPreconversion = emptyOr(input.minPreconversion, 'minPreconversion');
+    const maxPreconversion = emptyOr(input.maxPreconversion, 'maxPreconversion');
+    // The daemon rejects any maximum below its own minimum (crosschainrpc.cpp).
+    if (minPreconversion.length && maxPreconversion.length) {
+        for (let i = 0; i < currencies.length; i++) {
+            const min = minPreconversion[i];
+            const max = maxPreconversion[i];
+            if (min !== undefined && max !== undefined && max < min) {
+                throw new errors_js_1.TransactionBuildError(`maxPreconversion[${i}] (${max}) must be ≥ minPreconversion[${i}] (${min})`);
+            }
+        }
+    }
+    return {
+        version: exports.CURRENCY_DEFINITION_VERSION,
+        options: input.options,
+        parent: input.parent,
+        name: input.name,
+        launchSystemId,
+        systemId,
+        notarizationProtocol: input.notarizationProtocol ?? exports.NOTARIZATION_PROTOCOL.AUTO,
+        proofProtocol: input.proofProtocol ?? exports.PROOF_PROTOCOL.CHAINID,
+        startBlock: input.startBlock ?? 0,
+        endBlock: input.endBlock ?? 0,
+        initialFractionalSupply: input.initialSupply ?? 0n,
+        preAllocations: input.preAllocations ?? [],
+        gatewayConverterIssuance: 0n,
+        currencies,
+        // Normalized to sum to 1e8 (computed and range-checked above).
+        weights: fractionalWeights,
+        // A fractional definition always carries a zero conversion vector (the daemon
+        // ignores any explicit `conversions` and derives launch prices); a
+        // non-fractional token has no reserves, hence an empty vector.
+        conversions: zeros(),
+        minPreconversion,
+        maxPreconversion,
+        // `initialContributions` and `preconverted` are internal to a fresh
+        // definition: both carry a zero per reserve currency (empty for a
+        // non-fractional token). Matches on-chain definitions.
+        initialContributions: zeros(),
+        preconverted: zeros(),
+        preLaunchDiscount: (0, wire_js_1.requireInt32Range)(input.preLaunchDiscount ?? 0n, 'preLaunchDiscount'),
+        preLaunchCarveOut: input.preLaunchCarveOut ?? 0,
+        notaries: [],
+        minNotariesConfirm: 0,
+        idRegistrationFees: (0, wire_js_1.requireInt64Range)(input.idRegistrationFees ?? DEFAULT_ID_REGISTRATION_FEE, 'idRegistrationFees'),
+        idReferralLevels: input.idReferralLevels ?? DEFAULT_ID_REFERRAL_LEVELS,
+        idImportFees: (0, wire_js_1.requireInt64Range)(input.idImportFees ?? DEFAULT_ID_IMPORT_FEE, 'idImportFees'),
+    };
+}
+const MAX_NAME_LEN = 64;
+/**
+ * Serialize a normalized currency definition to its `AsVector()` bytes — the
+ * blob carried as `vData[0]` of the EVAL_CURRENCY_DEFINITION output. Field order
+ * and encodings mirror `CCurrencyDefinition::SerializationOp` for the
+ * token/basket (non-gateway, non-PBaaS) case.
+ */
+function serializeNormalizedDefinition(def) {
+    const parts = [
+        (0, wire_js_1.uint32LE)(def.version, 'version'),
+        (0, wire_js_1.uint32LE)(def.options, 'options'),
+        (0, wire_js_1.uint160)(def.parent, 'parent'),
+        (0, wire_js_1.limitedString)(def.name, MAX_NAME_LEN, 'name'),
+        (0, wire_js_1.uint160)(def.launchSystemId, 'launchSystemId'),
+        (0, wire_js_1.uint160)(def.systemId, 'systemId'),
+        (0, wire_js_1.int32LE)(def.notarizationProtocol, 'notarizationProtocol'),
+        (0, wire_js_1.int32LE)(def.proofProtocol, 'proofProtocol'),
+        // nativeCurrencyID: a null CTransferDestination (type 0, empty destination) → `0000`.
+        Buffer.from([0x00, 0x00]),
+        // gatewayID: null uint160 for a non-gateway currency → 20 zero bytes.
+        Buffer.alloc(20),
+        (0, wire_js_1.varInt)(BigInt(def.startBlock), 'startBlock'),
+        (0, wire_js_1.varInt)(BigInt(def.endBlock), 'endBlock'),
+        (0, wire_js_1.int64LE)(def.initialFractionalSupply, 'initialSupply'),
+        // preAllocation: CompactSize count, then (uint160 recipient, int64 amount) pairs.
+        (0, index_js_1.writeCompactSize)(def.preAllocations.length),
+        ...def.preAllocations.flatMap((p, i) => [
+            (0, wire_js_1.uint160)(p.address, `preAllocations[${i}].address`),
+            (0, wire_js_1.int64LE)(p.amount, `preAllocations[${i}].amount`),
+        ]),
+        (0, wire_js_1.int64LE)(def.gatewayConverterIssuance, 'gatewayConverterIssuance'),
+        (0, wire_js_1.vectorU160)(def.currencies, 'currencies'),
+        (0, wire_js_1.vectorI32)(def.weights, 'weights'),
+        (0, wire_js_1.vectorI64)(def.conversions, 'conversions'),
+        (0, wire_js_1.vectorI64)(def.minPreconversion, 'minPreconversion'),
+        (0, wire_js_1.vectorI64)(def.maxPreconversion, 'maxPreconversion'),
+        (0, wire_js_1.vectorI64)(def.initialContributions, 'initialContributions'),
+        (0, wire_js_1.vectorI64)(def.preconverted, 'preconverted'),
+        (0, wire_js_1.varInt)(def.preLaunchDiscount, 'preLaunchDiscount'),
+        (0, wire_js_1.int32LE)(def.preLaunchCarveOut, 'preLaunchCarveOut'),
+        (0, wire_js_1.vectorU160)(def.notaries, 'notaries'),
+        (0, wire_js_1.varInt)(BigInt(def.minNotariesConfirm), 'minNotariesConfirm'),
+        (0, wire_js_1.varInt)(def.idRegistrationFees, 'idRegistrationFees'),
+        (0, wire_js_1.varInt)(BigInt(def.idReferralLevels), 'idReferralLevels'),
+        (0, wire_js_1.varInt)(def.idImportFees, 'idImportFees'),
+    ];
+    return Buffer.concat(parts);
+}
+/** EVAL_CURRENCY_DEFINITION (=2). */
+const EVAL_CURRENCY_DEFINITION = 2;
+/**
+ * Serialize a currency definition to its `CCurrencyDefinition::AsVector()` bytes.
+ * Exposed mainly for byte-level testing; most callers want
+ * {@link buildCurrencyDefinitionScript}.
+ */
+function serializeCurrencyDefinition(input) {
+    return serializeNormalizedDefinition(normalizeCurrencyDefinition(input));
+}
+/**
+ * Build the EVAL_CURRENCY_DEFINITION CryptoCondition output script for a token or
+ * fractional basket, as a hex string — byte-equivalent to the output the daemon's
+ * `definecurrency` produces for the same parameters. For building, inspecting, or
+ * verifying a definition script offline; a full on-chain launch is a daemon
+ * operation (the transaction also needs live-state notarization outputs).
+ */
+function buildCurrencyDefinitionScript(input) {
+    const defBytes = serializeNormalizedDefinition(normalizeCurrencyDefinition(input));
+    return (0, wire_js_1.wrapCcOutput)(EVAL_CURRENCY_DEFINITION, [defBytes], {
+        kind: 'pubkey',
+        pubkey: CURRENCY_DEFINITION_PUBKEY,
+    }).toString('hex');
+}
+//# sourceMappingURL=definition.js.map

package/dist/currency/definition.js.map

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

package/dist/currency/index.d.ts

@@ -1,16 +1,26 @@
 /**
- * Currency definition (manual mode only — offline)
+ * Currency helpers — all offline, byte-equivalent to the daemon.
  *
- * Creates a currency definition transaction. Requires a pre-built
- * currency definition script hex (obtained externally).
+ * - `buildCurrencyDefinitionScript` / `serializeCurrencyDefinition`: the
+ *   EVAL_CURRENCY_DEFINITION output script (token, fractional basket, or NFT).
+ * - `buildCurrencyLaunchOutputs`: all seven outputs of a currency-definition tx.
+ * - `buildCurrencyLaunchTransaction`: a complete, signed, broadcastable launch.
+ * - `buildReserveTransferOutput`: the (pre)convert output for investing in a
+ *   launching currency.
  *
- * Currency creation requires:
- * 1. An existing identity with the same name
- * 2. The identity's FLAG_ACTIVECURRENCY must be set
- * 3. A currency definition output (EVAL_CURRENCY_DEFINITION)
+ * `defineCurrency` is a narrower helper (identity-spend + a pre-built definition
+ * output + change); prefer `buildCurrencyLaunchTransaction` for a full launch.
  */
 export { classifyCurrency, CURRENCY_TYPE_ORDER } from './classify.js';
 export type { CurrencyType } from './classify.js';
+export { serializeCurrencyDefinition, buildCurrencyDefinitionScript, CURRENCY_OPTION, CURRENCY_DEFINITION_VERSION, NOTARIZATION_PROTOCOL, PROOF_PROTOCOL, } from './definition.js';
+export type { CurrencyDefinitionInput } from './definition.js';
+export { buildCurrencyLaunchOutputs } from './outputs.js';
+export type { CurrencyLaunchContext, CurrencyLaunchOutputs, CurrencyLaunchOutput } from './outputs.js';
+export { buildCurrencyLaunchTransaction } from './launch.js';
+export type { CurrencyLaunchTxParams, CurrencyLaunchTxResult } from './launch.js';
+export { buildReserveTransferOutput } from './reserveTransfer.js';
+export type { ReserveTransferParams, ReserveTransferBuildResult } from './reserveTransfer.js';
 import type { Network } from '../constants/index.js';
 import type { DefineCurrencyParams, DefineCurrencyResult } from '../types/index.js';
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/currency/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACtE,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAKlD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAKrD,OAAO,KAAK,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAIpF;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,oBAAoB,EAC5B,OAAO,EAAE,OAAO,GACf,oBAAoB,CAmEtB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/currency/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACtE,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAGlD,OAAO,EACL,2BAA2B,EAC3B,6BAA6B,EAC7B,eAAe,EACf,2BAA2B,EAC3B,qBAAqB,EACrB,cAAc,GACf,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAK/D,OAAO,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAC1D,YAAY,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAGvG,OAAO,EAAE,8BAA8B,EAAE,MAAM,aAAa,CAAC;AAC7D,YAAY,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAIlF,OAAO,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAClE,YAAY,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAK9F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAKrD,OAAO,KAAK,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAIpF;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,oBAAoB,EAC5B,OAAO,EAAE,OAAO,GACf,oBAAoB,CAoEtB"}