@getomnichain/omnichain 0.2.0

package/dist/utxo/utxo_chains.js

@@ -0,0 +1,63 @@
+import { bitcoinMainnetChain, bitcoinRegtestChain, bitcoinSignetChain, bitcoinTestnetChain, } from "./btc/btc_chains.js";
+import { dogecoinMainnetChain, dogecoinTestnetChain, } from "./doge/doge_chains.js";
+import { litecoinMainnetChain, litecoinTestnetChain, } from "./ltc/ltc_chains.js";
+import { Slip44 } from "./utxo_network_params.js";
+export const UtxoCoin = {
+    Bitcoin: 'bitcoin',
+    BitcoinTestnet: 'bitcoin-testnet',
+    BitcoinSignet: 'bitcoin-signet',
+    BitcoinRegtest: 'bitcoin-regtest',
+    Litecoin: 'litecoin',
+    LitecoinTestnet: 'litecoin-testnet',
+    Dogecoin: 'dogecoin',
+    DogecoinTestnet: 'dogecoin-testnet',
+};
+export function utxoChainFromCoin(options) {
+    switch (options.coin) {
+        case UtxoCoin.Bitcoin:
+            return bitcoinMainnetChain(options);
+        case UtxoCoin.BitcoinTestnet:
+            return bitcoinTestnetChain(options);
+        case UtxoCoin.BitcoinSignet:
+            return bitcoinSignetChain(options);
+        case UtxoCoin.BitcoinRegtest:
+            return bitcoinRegtestChain(options);
+        case UtxoCoin.Litecoin:
+            return litecoinMainnetChain(options);
+        case UtxoCoin.LitecoinTestnet:
+            return litecoinTestnetChain(options);
+        case UtxoCoin.Dogecoin:
+            return dogecoinMainnetChain(options);
+        case UtxoCoin.DogecoinTestnet:
+            return dogecoinTestnetChain(options);
+        default: {
+            const exhaustive = options;
+            throw new Error(`utxoChainFromCoin: unknown coin ${exhaustive.coin}`);
+        }
+    }
+}
+export function utxoChainFromSlip44(slip44CoinId, isMainnet, options) {
+    if (isMainnet) {
+        if (slip44CoinId === Slip44.BTC)
+            return bitcoinMainnetChain(options);
+        if (slip44CoinId === Slip44.LTC)
+            return litecoinMainnetChain(options);
+        if (slip44CoinId === Slip44.DOGE)
+            return dogecoinMainnetChain(options);
+        throw new Error(`utxoChainFromSlip44: no mainnet chain for SLIP-44 coin ${slip44CoinId}`);
+    }
+    const variant = options.variant ?? 'testnet';
+    if (slip44CoinId === Slip44.BTC || slip44CoinId === Slip44.Testnet) {
+        if (variant === 'signet')
+            return bitcoinSignetChain(options);
+        if (variant === 'regtest')
+            return bitcoinRegtestChain(options);
+        return bitcoinTestnetChain(options);
+    }
+    if (slip44CoinId === Slip44.LTC)
+        return litecoinTestnetChain(options);
+    if (slip44CoinId === Slip44.DOGE)
+        return dogecoinTestnetChain(options);
+    throw new Error(`utxoChainFromSlip44: no testnet chain for SLIP-44 coin ${slip44CoinId}`);
+}
+//# sourceMappingURL=utxo_chains.js.map

package/dist/utxo/utxo_chains.js.map

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

package/dist/utxo/utxo_gas_pricing.d.ts

@@ -0,0 +1,22 @@
+import { AbstractGasPricing } from '../abstract_gas_pricing.ts';
+import { NetworkType } from '../network_type.ts';
+export interface UtxoGasPricingInit {
+    /**
+     * Fee rate in satoshis per virtual byte. Bitcoin Core `estimatesmartfee`
+     * returns BTC-per-kB; the SDK's `suggestFeeRate` already normalizes to
+     * sat/vB, and `UtxoGasPricing` accepts the same unit for consumer
+     * parity.
+     */
+    satsPerVByte: number;
+}
+/**
+ * UTXO explicit-fee override — mirrors Python's `UtxoGasPricing` at
+ * `impl/utxo/base.py`. Alternative to passing a `FeePriority` tier;
+ * the tier is resolved via `suggestFeeRate`.
+ */
+export declare class UtxoGasPricing extends AbstractGasPricing {
+    readonly networkType = NetworkType.BTC;
+    readonly satsPerVByte: number;
+    constructor(init: UtxoGasPricingInit);
+}
+//# sourceMappingURL=utxo_gas_pricing.d.ts.map

package/dist/utxo/utxo_gas_pricing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utxo_gas_pricing.d.ts","sourceRoot":"","sources":["../../utxo/utxo_gas_pricing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEhE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,WAAW,kBAAkB;IACjC;;;;;OAKG;IACH,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,qBAAa,cAAe,SAAQ,kBAAkB;IACpD,QAAQ,CAAC,WAAW,mBAAmB;IACvC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;gBAElB,IAAI,EAAE,kBAAkB;CAUrC"}

package/dist/utxo/utxo_gas_pricing.js

@@ -0,0 +1,20 @@
+import { AbstractGasPricing } from "../abstract_gas_pricing.js";
+import { ChainError, ChainErrorKinds } from "../errors.js";
+import { NetworkType } from "../network_type.js";
+/**
+ * UTXO explicit-fee override — mirrors Python's `UtxoGasPricing` at
+ * `impl/utxo/base.py`. Alternative to passing a `FeePriority` tier;
+ * the tier is resolved via `suggestFeeRate`.
+ */
+export class UtxoGasPricing extends AbstractGasPricing {
+    networkType = NetworkType.BTC;
+    satsPerVByte;
+    constructor(init) {
+        super();
+        if (!Number.isFinite(init.satsPerVByte) || init.satsPerVByte < 0) {
+            throw new ChainError(ChainErrorKinds.InvalidArgument, `UtxoGasPricing.satsPerVByte must be a non-negative finite number, got ${init.satsPerVByte}`);
+        }
+        this.satsPerVByte = init.satsPerVByte;
+    }
+}
+//# sourceMappingURL=utxo_gas_pricing.js.map

package/dist/utxo/utxo_gas_pricing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utxo_gas_pricing.js","sourceRoot":"","sources":["../../utxo/utxo_gas_pricing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAYjD;;;;GAIG;AACH,MAAM,OAAO,cAAe,SAAQ,kBAAkB;IAC3C,WAAW,GAAG,WAAW,CAAC,GAAG,CAAC;IAC9B,YAAY,CAAS;IAE9B,YAAY,IAAwB;QAClC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,IAAI,CAAC,YAAY,GAAG,CAAC,EAAE,CAAC;YACjE,MAAM,IAAI,UAAU,CAClB,eAAe,CAAC,eAAe,EAC/B,yEAAyE,IAAI,CAAC,YAAY,EAAE,CAC7F,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;IACxC,CAAC;CACF"}

package/dist/utxo/utxo_network_params.d.ts

@@ -0,0 +1,25 @@
+import { networks } from 'bitcoinjs-lib';
+export declare const Slip44: {
+    readonly BTC: 0;
+    readonly Testnet: 1;
+    readonly LTC: 2;
+    readonly DOGE: 3;
+};
+export type Slip44CoinId = (typeof Slip44)[keyof typeof Slip44] | number;
+export declare const BIP32_PURPOSE_P2PKH = 44;
+export declare const BIP32_PURPOSE_P2SH_P2WPKH = 49;
+export declare const BIP32_PURPOSE_P2WPKH = 84;
+export declare const BIP32_PURPOSE_P2TR = 86;
+export declare const FINAL_SEQUENCE = 4294967295;
+export declare const RBF_SEQUENCE = 4294967293;
+export declare const OP_RETURN_MAX_BYTES = 80;
+export declare const DEFAULT_DUST_SATS = 546;
+export interface UtxoNetworkParams {
+    name: string;
+    slip44CoinId: number;
+    networkInfo: networks.Network;
+    supportedDerivationPurposes: ReadonlySet<number>;
+    dustValueSats: number;
+    walletAddressRegex: RegExp;
+}
+//# sourceMappingURL=utxo_network_params.d.ts.map

package/dist/utxo/utxo_network_params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utxo_network_params.d.ts","sourceRoot":"","sources":["../../utxo/utxo_network_params.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,eAAO,MAAM,MAAM;;;;;CAKT,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,OAAO,MAAM,CAAC,GAAG,MAAM,CAAC;AAEzE,eAAO,MAAM,mBAAmB,KAAK,CAAC;AACtC,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAC5C,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC,eAAO,MAAM,cAAc,aAAa,CAAC;AACzC,eAAO,MAAM,YAAY,aAAa,CAAC;AACvC,eAAO,MAAM,mBAAmB,KAAK,CAAC;AACtC,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAErC,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,QAAQ,CAAC,OAAO,CAAC;IAC9B,2BAA2B,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACjD,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;CAC5B"}

package/dist/utxo/utxo_network_params.js

@@ -0,0 +1,15 @@
+export const Slip44 = {
+    BTC: 0,
+    Testnet: 1,
+    LTC: 2,
+    DOGE: 3,
+};
+export const BIP32_PURPOSE_P2PKH = 44;
+export const BIP32_PURPOSE_P2SH_P2WPKH = 49;
+export const BIP32_PURPOSE_P2WPKH = 84;
+export const BIP32_PURPOSE_P2TR = 86;
+export const FINAL_SEQUENCE = 0xffffffff;
+export const RBF_SEQUENCE = 0xfffffffd;
+export const OP_RETURN_MAX_BYTES = 80;
+export const DEFAULT_DUST_SATS = 546;
+//# sourceMappingURL=utxo_network_params.js.map

package/dist/utxo/utxo_network_params.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utxo_network_params.js","sourceRoot":"","sources":["../../utxo/utxo_network_params.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,GAAG,EAAE,CAAC;IACN,OAAO,EAAE,CAAC;IACV,GAAG,EAAE,CAAC;IACN,IAAI,EAAE,CAAC;CACC,CAAC;AAIX,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AACtC,MAAM,CAAC,MAAM,yBAAyB,GAAG,EAAE,CAAC;AAC5C,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC;AACvC,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAErC,MAAM,CAAC,MAAM,cAAc,GAAG,UAAU,CAAC;AACzC,MAAM,CAAC,MAAM,YAAY,GAAG,UAAU,CAAC;AACvC,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AACtC,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAC"}

package/dist/utxo/utxo_transaction_status.d.ts

@@ -0,0 +1,73 @@
+import { NestedBalanceChanges, TransactionErrorInfo, TransactionStatus, TransactionStatusType } from '../transaction_status.ts';
+export interface UtxoTransactionFeesInit {
+    absoluteSats: bigint;
+    vsize: number | null;
+}
+export declare class UtxoTransactionFees {
+    readonly absoluteSats: bigint;
+    readonly vsize: number | null;
+    constructor(init: UtxoTransactionFeesInit);
+    /** Fee rate in sat/vB. `null` when vsize is null or zero. */
+    get satsPerVByte(): number | null;
+}
+export interface UtxoTransactionOutputInit {
+    scriptPubkeyHex: string;
+    address: string | null;
+    valueSats: bigint;
+}
+export declare class UtxoTransactionOutput {
+    readonly scriptPubkeyHex: string;
+    readonly address: string | null;
+    readonly valueSats: bigint;
+    constructor(init: UtxoTransactionOutputInit);
+}
+export interface UtxoTransactionStatusInit {
+    chainId: number;
+    status: TransactionStatusType;
+    /**
+     * Aliased to the parent `inclusionAt`. Named `confirmationAt` here to
+     * mirror Python's `UtxoTransactionStatus.__init__` param
+     * `confirmation_datetime_utc` (impl/utxo/base.py:682).
+     */
+    confirmationAt?: Date | null;
+    balanceChanges?: NestedBalanceChanges | null;
+    error?: TransactionErrorInfo | null;
+    outputs?: readonly UtxoTransactionOutput[] | null;
+    vsize?: number | null;
+    confirmations?: number | null;
+    fees?: UtxoTransactionFees | null;
+}
+/**
+ * UTXO tx status. Python parity: no static factory methods; consumers build
+ * via the constructor directly (impl/utxo/base.py:677-728). Adds `fees` for
+ * parity with EVM/Solana subclass surfaces — Python's UTXO base omits it,
+ * but the consumer's deposit-detector needs the fee to reconcile net-of-fee
+ * balances. Documented deviation in SINAN_OPEN_QUESTIONS.md.
+ *
+ * **Important semantic caveat vs EVM/Solana**: `balanceChanges` on
+ * `UtxoTransactionStatus` are **gross output credits** per receiving
+ * address, NOT net per-wallet deltas. UTXO tools currently return only
+ * `vin.txid` + `vout` from providers — no per-input address/value — so the
+ * SDK can't debit inputs. A hot-wallet withdrawal will therefore record
+ * that wallet's own **change output** as a positive `AssetBalanceChange`,
+ * NOT a net debit. Consumers doing uniform cross-chain balance
+ * reconciliation must special-case UTXO. Input-side accounting is deferred
+ * to a later phase.
+ *
+ * `inputs` is not yet surfaced (the raw-tx provider returns only txid+vout,
+ * insufficient for a meaningful shape). Comes back in the 2C UTXO port.
+ */
+export declare class UtxoTransactionStatus extends TransactionStatus {
+    readonly outputs: readonly UtxoTransactionOutput[] | null;
+    readonly vsize: number | null;
+    readonly confirmations: number | null;
+    readonly fees: UtxoTransactionFees | null;
+    constructor(init: UtxoTransactionStatusInit);
+    /**
+     * Alias for the parent's `inclusionAt` field, exposed under the Python name
+     * `confirmationAt` for readability at consumer call sites. Same underlying
+     * value; do not use both interchangeably in diffs.
+     */
+    get confirmationAt(): Date | null;
+}
+//# sourceMappingURL=utxo_transaction_status.d.ts.map

package/dist/utxo/utxo_transaction_status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utxo_transaction_status.d.ts","sourceRoot":"","sources":["../../utxo/utxo_transaction_status.ts"],"names":[],"mappings":"AACA,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,EACtB,MAAM,0BAA0B,CAAC;AAElC,MAAM,WAAW,uBAAuB;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,qBAAa,mBAAmB;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;gBAElB,IAAI,EAAE,uBAAuB;IAiBzC,6DAA6D;IAC7D,IAAI,YAAY,IAAI,MAAM,GAAG,IAAI,CAGhC;CACF;AAED,MAAM,WAAW,yBAAyB;IACxC,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,qBAAqB;IAChC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,IAAI,EAAE,yBAAyB;CAW5C;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,qBAAqB,CAAC;IAC9B;;;;OAIG;IACH,cAAc,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAC7B,cAAc,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC7C,KAAK,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACpC,OAAO,CAAC,EAAE,SAAS,qBAAqB,EAAE,GAAG,IAAI,CAAC;IAClD,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,IAAI,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,qBAAsB,SAAQ,iBAAiB;IAC1D,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,GAAG,IAAI,CAAC;IAC1D,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,GAAG,IAAI,CAAC;gBAE9B,IAAI,EAAE,yBAAyB;IA0B3C;;;;OAIG;IACH,IAAI,cAAc,IAAI,IAAI,GAAG,IAAI,CAEhC;CACF"}

package/dist/utxo/utxo_transaction_status.js

@@ -0,0 +1,89 @@
+import { ChainError, ChainErrorKinds } from "../errors.js";
+import { TransactionStatus, } from "../transaction_status.js";
+export class UtxoTransactionFees {
+    absoluteSats;
+    vsize;
+    constructor(init) {
+        if (init.absoluteSats < 0n) {
+            throw new ChainError(ChainErrorKinds.InvalidArgument, `UtxoTransactionFees.absoluteSats must be >= 0, got ${init.absoluteSats}`);
+        }
+        if (init.vsize !== null && (!Number.isFinite(init.vsize) || init.vsize < 0)) {
+            throw new ChainError(ChainErrorKinds.InvalidArgument, `UtxoTransactionFees.vsize must be a non-negative number or null, got ${init.vsize}`);
+        }
+        this.absoluteSats = init.absoluteSats;
+        this.vsize = init.vsize;
+    }
+    /** Fee rate in sat/vB. `null` when vsize is null or zero. */
+    get satsPerVByte() {
+        if (this.vsize === null || this.vsize === 0)
+            return null;
+        return Number(this.absoluteSats) / this.vsize;
+    }
+}
+export class UtxoTransactionOutput {
+    scriptPubkeyHex;
+    address;
+    valueSats;
+    constructor(init) {
+        if (init.valueSats < 0n) {
+            throw new ChainError(ChainErrorKinds.InvalidArgument, `UtxoTransactionOutput.valueSats must be >= 0, got ${init.valueSats}`);
+        }
+        this.scriptPubkeyHex = init.scriptPubkeyHex;
+        this.address = init.address;
+        this.valueSats = init.valueSats;
+    }
+}
+/**
+ * UTXO tx status. Python parity: no static factory methods; consumers build
+ * via the constructor directly (impl/utxo/base.py:677-728). Adds `fees` for
+ * parity with EVM/Solana subclass surfaces — Python's UTXO base omits it,
+ * but the consumer's deposit-detector needs the fee to reconcile net-of-fee
+ * balances. Documented deviation in SINAN_OPEN_QUESTIONS.md.
+ *
+ * **Important semantic caveat vs EVM/Solana**: `balanceChanges` on
+ * `UtxoTransactionStatus` are **gross output credits** per receiving
+ * address, NOT net per-wallet deltas. UTXO tools currently return only
+ * `vin.txid` + `vout` from providers — no per-input address/value — so the
+ * SDK can't debit inputs. A hot-wallet withdrawal will therefore record
+ * that wallet's own **change output** as a positive `AssetBalanceChange`,
+ * NOT a net debit. Consumers doing uniform cross-chain balance
+ * reconciliation must special-case UTXO. Input-side accounting is deferred
+ * to a later phase.
+ *
+ * `inputs` is not yet surfaced (the raw-tx provider returns only txid+vout,
+ * insufficient for a meaningful shape). Comes back in the 2C UTXO port.
+ */
+export class UtxoTransactionStatus extends TransactionStatus {
+    outputs;
+    vsize;
+    confirmations;
+    fees;
+    constructor(init) {
+        super({
+            chainId: init.chainId,
+            status: init.status,
+            inclusionAt: init.confirmationAt,
+            error: init.error,
+            balanceChanges: init.balanceChanges,
+        });
+        if (init.vsize !== undefined && init.vsize !== null && init.vsize < 0) {
+            throw new ChainError(ChainErrorKinds.InvalidArgument, `UtxoTransactionStatus.vsize must be >= 0 or null, got ${init.vsize}`);
+        }
+        if (init.confirmations !== undefined && init.confirmations !== null && init.confirmations < 0) {
+            throw new ChainError(ChainErrorKinds.InvalidArgument, `UtxoTransactionStatus.confirmations must be >= 0 or null, got ${init.confirmations}`);
+        }
+        this.outputs = init.outputs ?? null;
+        this.vsize = init.vsize ?? null;
+        this.confirmations = init.confirmations ?? null;
+        this.fees = init.fees ?? null;
+    }
+    /**
+     * Alias for the parent's `inclusionAt` field, exposed under the Python name
+     * `confirmationAt` for readability at consumer call sites. Same underlying
+     * value; do not use both interchangeably in diffs.
+     */
+    get confirmationAt() {
+        return this.inclusionAt;
+    }
+}
+//# sourceMappingURL=utxo_transaction_status.js.map

package/dist/utxo/utxo_transaction_status.js.map

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

package/docs/PUBLISHING.md

@@ -0,0 +1,119 @@
+# Publishing `@getomnichain/omnichain`
+
+One-time setup + per-release workflow. Assumes the repo is being migrated from `pluton-bridge/omnichain` (private, source-only submodule) to `getomnichain/omnichain` (public, npm-published package).
+
+## Naming convention rationale
+
+Per the [npm docs](https://docs.npmjs.com/cli/v11/using-npm/scope/) and the [npm naming policy](https://docs.npmjs.com/files/package.json/): **don't put `js` or `node` in the name — it's assumed.** No `.js` suffix (that convention is only used when the library IS the framework, e.g. `three`, and even then modern projects drop it). No uppercase. Scoped names for org identity are the current standard.
+
+- **Package name:** `@getomnichain/omnichain`
+- **Rejected:** `omnichain.js` (anti-idiom for TS-first libs); `omnichain-ts` (redundant — types ship inside); bare `omnichain` (unscoped, larger namespace-collision risk)
+- **npm slot check** (`2026-07-27`): `omnichain` and `@getomnichain/*` both `404 Not Found` on the registry — both free.
+
+Mirrors Python: `getomnichain/omnichain-py` on GitHub + `omnichain-py` on PyPI. TS gets `getomnichain/omnichain` on GitHub + `@getomnichain/omnichain` on npm.
+
+## One-time setup
+
+### 1. Create GitHub repo under the org
+
+```bash
+# Requires a PAT with `repo` scope + membership in the `getomnichain` org.
+gh repo create getomnichain/omnichain \
+  --public \
+  --description "Multi-chain SDK — TS parity port of omnichain-py" \
+  --source . \
+  --push
+```
+
+`gh repo create` will not overwrite an existing remote; if you already ran it, add the remote by hand:
+
+```bash
+git remote add upstream https://github.com/getomnichain/omnichain.git
+git push upstream main
+```
+
+Keep `origin` pointing at `pluton-bridge/omnichain` until you're ready to sunset the private mirror. `scripts/release.sh` pushes to both remotes on every release.
+
+### 2. Create the npm org
+
+Log in to npmjs.com and create the `getomnichain` organization (Free tier is fine for public packages). Add publisher accounts as members.
+
+### 3. Generate an npm automation token
+
+Account → Access Tokens → New Automation Token (scope: **Publish**, allowlist to `@getomnichain/*`). Store it as `NPM_TOKEN`:
+
+```bash
+# Local dev: put it in ~/.npmrc under a home-scoped auth line, OR set env each release
+export NPM_TOKEN=npm_XXXXXXXXXXXXX
+
+# CI: add to repo secrets as NPM_TOKEN (used by scripts/release.sh)
+gh secret set NPM_TOKEN --repo getomnichain/omnichain
+```
+
+### 4. Install build + test deps
+
+`package.json` is checked in but `node_modules/` is not. First-time bootstrap:
+
+```bash
+npm install
+```
+
+### 5. Sanity-check the build
+
+```bash
+npm run typecheck    # tsc --noEmit
+npm run build        # emits dist/
+npm test             # jest via @jest/globals
+```
+
+`npm run build` uses `tsc` with `rewriteRelativeImportExtensions: true` (TS 5.7+) so the source's `.ts` extension imports emit as `.js` in `dist/`. If a consumer is stuck on TS ≤ 5.6, `dist/` is still valid JS — this only matters for developing this package.
+
+## Per-release workflow
+
+`scripts/release.sh` does everything atomically. From a clean working tree on the branch you're releasing:
+
+```bash
+scripts/release.sh patch       # 0.2.0 → 0.2.1  (backport/bug fix)
+scripts/release.sh minor       # 0.2.0 → 0.3.0  (additive)
+scripts/release.sh major       # 0.2.0 → 1.0.0  (breaking)
+scripts/release.sh 0.2.1       # explicit
+```
+
+Steps run in this order (fails fast if any step errors):
+
+1. Reject if working tree dirty.
+2. `npm version <bump> --no-git-tag-version` — bumps `package.json`.
+3. `git commit` + `git tag v<X.Y.Z>`.
+4. `npm run build` — produces `dist/`.
+5. `npm publish --access public` — uses `NPM_TOKEN` if set, else interactive auth.
+6. `git push origin <branch> && git push origin v<X.Y.Z>`.
+7. Same to `upstream` if configured.
+
+Requires the caller to be on the branch they want to release from. Typical flow: land your feature branch to `main`, `git checkout main && git pull`, then `scripts/release.sh minor`.
+
+## What ships to npm vs what stays on GitHub
+
+Controlled by the `files` allowlist in `package.json` (more restrictive than `.npmignore`). Currently:
+
+- **Ships:** `dist/`, `docs/`, `README.md`, `LICENSE`, `CHANGELOG.md`, `package.json`.
+- **Stays on GitHub only:** `test/`, `**/test/`, `code-review/`, source `.ts` files, `.claude/`, `scripts/`, `tsconfig*.json`.
+
+Consumers get the compiled `.js` + `.d.ts` in `dist/`, keeping the tarball small. Source is browsable on GitHub for anyone who wants to read the implementation.
+
+## Version policy
+
+- **`0.x`** while the API is still tracking Python-parity waves. Any wave that changes an existing public API is a **minor** bump under 0.x semver (breaking changes without a major bump are permitted only in 0.x).
+- **`1.0`** ships once every deferred Wave 2B item is wired (`isFullBalance`, `gasPricing` per-chain, UTXO `amountHr` design pass) AND parity with `omnichain-py` `main` is asserted.
+
+## Reverting a bad publish
+
+npm allows `npm unpublish` only within 72 hours and only if no dependents exist. Prefer publishing a `.1` patch with a fix over unpublishing.
+
+```bash
+# If truly urgent, within 72h, and nobody depends on it:
+npm unpublish @getomnichain/omnichain@0.2.1
+```
+
+## Migrating consumers from the git submodule
+
+Consumers currently importing `omnichain` as a git submodule (e.g. under `services/*/omnichain/`) should switch to `@getomnichain/omnichain` in `package.json` on the same commit that lands `npm install decimal.js` (the Wave 2B hard merge gate). Bumps become `npm install @getomnichain/omnichain@0.2.0` instead of `git submodule update --remote`.