crypto-aio 0.0.2 → 0.1.0

package/dist/core/model/asset.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assetId = assetId;
+exports.isAssetId = isAssetId;
+exports.parseAssetId = parseAssetId;
+exports.sameAssetRef = sameAssetRef;
+exports.metadataProblem = metadataProblem;
+const error_1 = require("../errors/error");
+const ASSET_ID = /^([a-z][a-z0-9-]*):([a-z0-9-]+)\/(?:(native)|([a-z0-9-]+):(.+))$/;
+function assetId(chain, network, ref) {
+    return ref === 'native'
+        ? `${chain}:${network}/native`
+        : `${chain}:${network}/${ref.standard}:${ref.contract}`;
+}
+function isAssetId(value) {
+    return ASSET_ID.test(value);
+}
+function parseAssetId(id) {
+    const match = ASSET_ID.exec(id);
+    // A malformed id is the caller's text, which may be a pasted secret: never repeated.
+    if (!match)
+        throw new error_1.ValidationError('ASSET_RESOLUTION', 'malformed asset id');
+    const [, chain, network, native, standard, contract] = match;
+    return {
+        chain: chain,
+        network: network,
+        ref: native
+            ? 'native'
+            : { standard: standard, contract: contract },
+    };
+}
+function sameAssetRef(a, b) {
+    if (a === 'native' || b === 'native')
+        return a === b;
+    return a.standard === b.standard && a.contract === b.contract;
+}
+/** Returns a reason when metadata is unusable, otherwise `undefined`. */
+function metadataProblem(metadata) {
+    if (!metadata.symbol)
+        return 'symbol must not be empty';
+    const { decimals } = metadata;
+    if (!Number.isInteger(decimals) || decimals < 0 || decimals > 255) {
+        return 'decimals must be an integer in [0, 255]';
+    }
+    return undefined;
+}
+//# sourceMappingURL=asset.js.map

package/dist/core/model/asset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset.js","sourceRoot":"","sources":["../../../src/core/model/asset.ts"],"names":[],"mappings":";;AAuBA,0BAIC;AAED,8BAEC;AAED,oCAgBC;AAED,oCAGC;AAGD,0CAOC;AAhED,2CAAkD;AAqBlD,MAAM,QAAQ,GAAG,kEAAkE,CAAC;AAEpF,SAAgB,OAAO,CAAC,KAAa,EAAE,OAAe,EAAE,GAAa;IACnE,OAAO,GAAG,KAAK,QAAQ;QACrB,CAAC,CAAC,GAAG,KAAK,IAAI,OAAO,SAAS;QAC9B,CAAC,CAAC,GAAG,KAAK,IAAI,OAAO,IAAI,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;AAC5D,CAAC;AAED,SAAgB,SAAS,CAAC,KAAa;IACrC,OAAO,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED,SAAgB,YAAY,CAAC,EAAU;IAKrC,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChC,qFAAqF;IACrF,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,uBAAe,CAAC,kBAAkB,EAAE,oBAAoB,CAAC,CAAC;IAChF,MAAM,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,GAAG,KAAK,CAAC;IAC7D,OAAO;QACL,KAAK,EAAE,KAAe;QACtB,OAAO,EAAE,OAAiB;QAC1B,GAAG,EAAE,MAAM;YACT,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAkB,EAAE,QAAQ,EAAE,QAAkB,EAAE;KACnE,CAAC;AACJ,CAAC;AAED,SAAgB,YAAY,CAAC,CAAW,EAAE,CAAW;IACnD,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,QAAQ;QAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACrD,OAAO,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,QAAQ,CAAC;AAChE,CAAC;AAED,yEAAyE;AACzE,SAAgB,eAAe,CAAC,QAAuB;IACrD,IAAI,CAAC,QAAQ,CAAC,MAAM;QAAE,OAAO,0BAA0B,CAAC;IACxD,MAAM,EAAE,QAAQ,EAAE,GAAG,QAAQ,CAAC;IAC9B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,IAAI,QAAQ,GAAG,GAAG,EAAE,CAAC;QAClE,OAAO,yCAAyC,CAAC;IACnD,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC","sourcesContent":["import { ValidationError } from '../errors/error';\n\nexport type AssetRef =\n  'native' | { readonly standard: string; readonly contract: string };\nexport type TokenRef = Exclude<AssetRef, 'native'>;\nexport type AssetId = string;\n\nexport interface AssetMetadata {\n  readonly symbol: string;\n  readonly decimals: number;\n  readonly name?: string;\n}\n\nexport interface AssetInfo {\n  readonly id: AssetId;\n  readonly chain: string;\n  readonly network: string;\n  readonly ref: AssetRef;\n  readonly metadata: AssetMetadata;\n}\n\nconst ASSET_ID = /^([a-z][a-z0-9-]*):([a-z0-9-]+)\\/(?:(native)|([a-z0-9-]+):(.+))$/;\n\nexport function assetId(chain: string, network: string, ref: AssetRef): AssetId {\n  return ref === 'native'\n    ? `${chain}:${network}/native`\n    : `${chain}:${network}/${ref.standard}:${ref.contract}`;\n}\n\nexport function isAssetId(value: string): boolean {\n  return ASSET_ID.test(value);\n}\n\nexport function parseAssetId(id: string): {\n  chain: string;\n  network: string;\n  ref: AssetRef;\n} {\n  const match = ASSET_ID.exec(id);\n  // A malformed id is the caller's text, which may be a pasted secret: never repeated.\n  if (!match) throw new ValidationError('ASSET_RESOLUTION', 'malformed asset id');\n  const [, chain, network, native, standard, contract] = match;\n  return {\n    chain: chain as string,\n    network: network as string,\n    ref: native\n      ? 'native'\n      : { standard: standard as string, contract: contract as string },\n  };\n}\n\nexport function sameAssetRef(a: AssetRef, b: AssetRef): boolean {\n  if (a === 'native' || b === 'native') return a === b;\n  return a.standard === b.standard && a.contract === b.contract;\n}\n\n/** Returns a reason when metadata is unusable, otherwise `undefined`. */\nexport function metadataProblem(metadata: AssetMetadata): string | undefined {\n  if (!metadata.symbol) return 'symbol must not be empty';\n  const { decimals } = metadata;\n  if (!Number.isInteger(decimals) || decimals < 0 || decimals > 255) {\n    return 'decimals must be an integer in [0, 255]';\n  }\n  return undefined;\n}\n"]}

package/dist/core/model/capability.d.ts

@@ -0,0 +1,3 @@
+export declare const KNOWN_CAPABILITIES: readonly ["tokens", "memo", "batch-transfer", "replace-fee", "cancel", "block-scan", "address-history", "finality-tag", "hd-public-derivation", "contract-read", "fee-market-1559", "expiry"];
+export type KnownCapability = (typeof KNOWN_CAPABILITIES)[number];
+export type Capability = KnownCapability | (string & {});

package/dist/core/model/capability.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KNOWN_CAPABILITIES = void 0;
+exports.KNOWN_CAPABILITIES = Object.freeze([
+    'tokens',
+    'memo',
+    'batch-transfer',
+    'replace-fee',
+    'cancel',
+    'block-scan',
+    'address-history',
+    'finality-tag',
+    'hd-public-derivation',
+    'contract-read',
+    'fee-market-1559',
+    'expiry',
+]);
+//# sourceMappingURL=capability.js.map

package/dist/core/model/capability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability.js","sourceRoot":"","sources":["../../../src/core/model/capability.ts"],"names":[],"mappings":";;;AAAa,QAAA,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC9C,QAAQ;IACR,MAAM;IACN,gBAAgB;IAChB,aAAa;IACb,QAAQ;IACR,YAAY;IACZ,iBAAiB;IACjB,cAAc;IACd,sBAAsB;IACtB,eAAe;IACf,iBAAiB;IACjB,QAAQ;CACA,CAAC,CAAC","sourcesContent":["export const KNOWN_CAPABILITIES = Object.freeze([\n  'tokens',\n  'memo',\n  'batch-transfer',\n  'replace-fee',\n  'cancel',\n  'block-scan',\n  'address-history',\n  'finality-tag',\n  'hd-public-derivation',\n  'contract-read',\n  'fee-market-1559',\n  'expiry',\n] as const);\n\nexport type KnownCapability = (typeof KNOWN_CAPABILITIES)[number];\nexport type Capability = KnownCapability | (string & {});\n"]}

package/dist/core/model/chain.d.ts

@@ -0,0 +1,63 @@
+import type { Capability } from './capability';
+import type { OrderingKind } from './ordering';
+export type FinalityPolicy = {
+    readonly kind: 'confirmations';
+    readonly confirmations: number;
+} | {
+    readonly kind: 'tag';
+    readonly tag: 'finalized';
+    readonly fallbackConfirmations: number;
+} | {
+    readonly kind: 'solidified';
+} | {
+    readonly kind: 'commitment';
+    readonly level: 'finalized';
+} | {
+    readonly kind: 'masterchain';
+};
+export interface NativeAssetInfo {
+    readonly symbol: string;
+    readonly decimals: number;
+    readonly name?: string;
+}
+export interface NetworkInfo {
+    readonly id: string;
+    /** Expected value of the driver's identity probe (chain id, genesis hash…). */
+    readonly identity?: string;
+    readonly testnet: boolean;
+    readonly feeModel: string;
+    readonly finality: FinalityPolicy;
+    readonly defaultConfirmations: number;
+    /** Recent blocks a scanner retains for rollback detection; independent of finality. */
+    readonly reorgWindow: number;
+    readonly maxLagBlocks?: number;
+    readonly explorer?: {
+        readonly tx: string;
+        readonly address: string;
+    };
+    readonly replacement?: {
+        readonly minBumpPercent: number;
+    };
+    readonly capabilities?: {
+        readonly add?: readonly Capability[];
+        readonly remove?: readonly Capability[];
+    };
+    readonly params?: Readonly<Record<string, unknown>>;
+}
+export interface ChainInfo {
+    readonly id: string;
+    readonly family: string;
+    readonly model: 'account' | 'utxo';
+    readonly ordering: OrderingKind;
+    readonly schemes: readonly string[];
+    readonly nativeAsset: NativeAssetInfo;
+    readonly defaultNetwork: string;
+    readonly networks: Readonly<Record<string, NetworkInfo>>;
+    /**
+     * Whether the chain's extended public keys carry their network class (SLIP-0132: `xpub`
+     * on mainnet, `tpub` on test networks), so `deriveAddress` refuses a key of the other
+     * class. Default: `true` for `utxo`-model chains, `false` for account-model ones.
+     */
+    readonly xpubNetworkClass?: boolean;
+}
+export declare function explorerUrl(network: NetworkInfo, kind: 'tx' | 'address', value: string): string | undefined;

package/dist/core/model/chain.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.explorerUrl = explorerUrl;
+function explorerUrl(network, kind, value) {
+    const template = network.explorer?.[kind];
+    return template?.replace(kind === 'tx' ? '{id}' : '{address}', encodeURIComponent(value));
+}
+//# sourceMappingURL=chain.js.map

package/dist/core/model/chain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain.js","sourceRoot":"","sources":["../../../src/core/model/chain.ts"],"names":[],"mappings":";;AAyDA,kCAUC;AAVD,SAAgB,WAAW,CACzB,OAAoB,EACpB,IAAsB,EACtB,KAAa;IAEb,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,CAAC;IAC1C,OAAO,QAAQ,EAAE,OAAO,CACtB,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,EACpC,kBAAkB,CAAC,KAAK,CAAC,CAC1B,CAAC;AACJ,CAAC","sourcesContent":["import type { Capability } from './capability';\nimport type { OrderingKind } from './ordering';\n\nexport type FinalityPolicy =\n  | { readonly kind: 'confirmations'; readonly confirmations: number }\n  | {\n      readonly kind: 'tag';\n      readonly tag: 'finalized';\n      readonly fallbackConfirmations: number;\n    }\n  | { readonly kind: 'solidified' }\n  | { readonly kind: 'commitment'; readonly level: 'finalized' }\n  | { readonly kind: 'masterchain' };\n\nexport interface NativeAssetInfo {\n  readonly symbol: string;\n  readonly decimals: number;\n  readonly name?: string;\n}\n\nexport interface NetworkInfo {\n  readonly id: string;\n  /** Expected value of the driver's identity probe (chain id, genesis hash…). */\n  readonly identity?: string;\n  readonly testnet: boolean;\n  readonly feeModel: string;\n  readonly finality: FinalityPolicy;\n  readonly defaultConfirmations: number;\n  /** Recent blocks a scanner retains for rollback detection; independent of finality. */\n  readonly reorgWindow: number;\n  readonly maxLagBlocks?: number;\n  readonly explorer?: { readonly tx: string; readonly address: string };\n  readonly replacement?: { readonly minBumpPercent: number };\n  readonly capabilities?: {\n    readonly add?: readonly Capability[];\n    readonly remove?: readonly Capability[];\n  };\n  readonly params?: Readonly<Record<string, unknown>>;\n}\n\nexport interface ChainInfo {\n  readonly id: string;\n  readonly family: string;\n  readonly model: 'account' | 'utxo';\n  readonly ordering: OrderingKind;\n  readonly schemes: readonly string[];\n  readonly nativeAsset: NativeAssetInfo;\n  readonly defaultNetwork: string;\n  readonly networks: Readonly<Record<string, NetworkInfo>>;\n  /**\n   * Whether the chain's extended public keys carry their network class (SLIP-0132: `xpub`\n   * on mainnet, `tpub` on test networks), so `deriveAddress` refuses a key of the other\n   * class. Default: `true` for `utxo`-model chains, `false` for account-model ones.\n   */\n  readonly xpubNetworkClass?: boolean;\n}\n\nexport function explorerUrl(\n  network: NetworkInfo,\n  kind: 'tx' | 'address',\n  value: string,\n): string | undefined {\n  const template = network.explorer?.[kind];\n  return template?.replace(\n    kind === 'tx' ? '{id}' : '{address}',\n    encodeURIComponent(value),\n  );\n}\n"]}

package/dist/core/model/fee.d.ts

@@ -0,0 +1,36 @@
+import type { Address } from './address';
+import type { Amount } from './amount';
+import type { AssetId, AssetRef } from './asset';
+export type FeeSpeed = 'slow' | 'normal' | 'fast';
+/** Family-specific explicit fee parameters (e.g. `{ maxFeePerGas }`, `{ satPerVByte }`). */
+export type FeeOverride = Readonly<Record<string, unknown>>;
+export type FeeBound = 'exact' | 'expected' | 'upper';
+export interface FeeChargeDraft {
+    readonly asset: AssetRef;
+    readonly amount: bigint;
+    readonly label: string;
+}
+/** Driver-level fee estimate (asset refs and base units). */
+export interface FeeEstimateDraft {
+    readonly kind: string;
+    readonly speed: FeeSpeed | 'custom';
+    readonly charges: readonly FeeChargeDraft[];
+    readonly bound: FeeBound;
+    readonly payer?: string;
+    readonly details: Readonly<Record<string, unknown>>;
+}
+export interface FeeCharge {
+    readonly amount: Amount;
+    readonly label: string;
+}
+export interface FeeEstimate {
+    readonly kind: string;
+    readonly speed: FeeSpeed | 'custom';
+    readonly charges: readonly FeeCharge[];
+    readonly bound: FeeBound;
+    readonly payer?: Address;
+    readonly details: Readonly<Record<string, unknown>>;
+}
+export declare function isFeeSpeed(value: unknown): value is FeeSpeed;
+/** Sum of all charges in one asset, or `undefined` when nothing is charged in it. */
+export declare function feeTotal(fee: FeeEstimate, asset: AssetId): Amount | undefined;

package/dist/core/model/fee.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isFeeSpeed = isFeeSpeed;
+exports.feeTotal = feeTotal;
+function isFeeSpeed(value) {
+    return value === 'slow' || value === 'normal' || value === 'fast';
+}
+/** Sum of all charges in one asset, or `undefined` when nothing is charged in it. */
+function feeTotal(fee, asset) {
+    let total;
+    for (const charge of fee.charges) {
+        if (charge.amount.asset.id === asset)
+            total = total ? total.plus(charge.amount) : charge.amount;
+    }
+    return total;
+}
+//# sourceMappingURL=fee.js.map

package/dist/core/model/fee.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fee.js","sourceRoot":"","sources":["../../../src/core/model/fee.ts"],"names":[],"mappings":";;AAuCA,gCAEC;AAGD,4BAOC;AAZD,SAAgB,UAAU,CAAC,KAAc;IACvC,OAAO,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,MAAM,CAAC;AACpE,CAAC;AAED,qFAAqF;AACrF,SAAgB,QAAQ,CAAC,GAAgB,EAAE,KAAc;IACvD,IAAI,KAAyB,CAAC;IAC9B,KAAK,MAAM,MAAM,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;QACjC,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,KAAK;YAClC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;IAC9D,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC","sourcesContent":["import type { Address } from './address';\nimport type { Amount } from './amount';\nimport type { AssetId, AssetRef } from './asset';\n\nexport type FeeSpeed = 'slow' | 'normal' | 'fast';\n/** Family-specific explicit fee parameters (e.g. `{ maxFeePerGas }`, `{ satPerVByte }`). */\nexport type FeeOverride = Readonly<Record<string, unknown>>;\nexport type FeeBound = 'exact' | 'expected' | 'upper';\n\nexport interface FeeChargeDraft {\n  readonly asset: AssetRef;\n  readonly amount: bigint;\n  readonly label: string;\n}\n\n/** Driver-level fee estimate (asset refs and base units). */\nexport interface FeeEstimateDraft {\n  readonly kind: string;\n  readonly speed: FeeSpeed | 'custom';\n  readonly charges: readonly FeeChargeDraft[];\n  readonly bound: FeeBound;\n  readonly payer?: string;\n  readonly details: Readonly<Record<string, unknown>>;\n}\n\nexport interface FeeCharge {\n  readonly amount: Amount;\n  readonly label: string;\n}\n\nexport interface FeeEstimate {\n  readonly kind: string;\n  readonly speed: FeeSpeed | 'custom';\n  readonly charges: readonly FeeCharge[];\n  readonly bound: FeeBound;\n  readonly payer?: Address;\n  readonly details: Readonly<Record<string, unknown>>;\n}\n\nexport function isFeeSpeed(value: unknown): value is FeeSpeed {\n  return value === 'slow' || value === 'normal' || value === 'fast';\n}\n\n/** Sum of all charges in one asset, or `undefined` when nothing is charged in it. */\nexport function feeTotal(fee: FeeEstimate, asset: AssetId): Amount | undefined {\n  let total: Amount | undefined;\n  for (const charge of fee.charges) {\n    if (charge.amount.asset.id === asset)\n      total = total ? total.plus(charge.amount) : charge.amount;\n  }\n  return total;\n}\n"]}

package/dist/core/model/ids.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Type-level registries. Users and plugins augment them through the package entry, e.g.
+ * `declare module 'crypto-aio' { interface ChainRegistry { ethereum: {...} } }`, and plugins
+ * inside this package augment the entry module (`declare module '../index'`). Never augment
+ * this file directly: an augmentation here and one through the entry are then merged in file
+ * order, and a user's chains can be lost.
+ */
+export interface ChainRegistry {
+}
+export interface FamilyRegistry {
+}
+export interface NativeClientMap {
+}
+export type ChainId = Extract<keyof ChainRegistry, string>;
+type ChainEntry<C extends ChainId> = ChainRegistry[C] extends {
+    family: string;
+    network: string;
+} ? ChainRegistry[C] : never;
+export type NetworkOf<C extends ChainId> = ChainEntry<C>['network'];
+export type FamilyOf<C extends ChainId> = ChainEntry<C>['family'];
+export type LibraryOf<C extends ChainId> = FamilyOf<C> extends keyof FamilyRegistry ? FamilyRegistry[FamilyOf<C>] extends {
+    library: infer L;
+} ? L : string : string;
+export type ExtOf<C extends ChainId> = FamilyOf<C> extends keyof FamilyRegistry ? FamilyRegistry[FamilyOf<C>] extends {
+    ext: infer E;
+} ? E : unknown : unknown;
+export declare const Library: Readonly<{
+    readonly ETHERS: "ethers";
+    readonly WEB3: "web3";
+    readonly TRONWEB: "tronweb";
+    readonly BITCOINJS_LIB: "bitcoinjs-lib";
+    readonly SOLANA_WEB3_JS: "@solana/web3.js";
+    readonly TON: "@ton/ton";
+    readonly AVALANCHEJS: "@avalabs/avalanchejs";
+}>;
+export type KnownLibrary = (typeof Library)[keyof typeof Library];
+export {};

package/dist/core/model/ids.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Library = void 0;
+exports.Library = Object.freeze({
+    ETHERS: 'ethers',
+    WEB3: 'web3',
+    TRONWEB: 'tronweb',
+    BITCOINJS_LIB: 'bitcoinjs-lib',
+    SOLANA_WEB3_JS: '@solana/web3.js',
+    TON: '@ton/ton',
+    AVALANCHEJS: '@avalabs/avalanchejs',
+});
+//# sourceMappingURL=ids.js.map

package/dist/core/model/ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../../../src/core/model/ids.ts"],"names":[],"mappings":";;;AAmCa,QAAA,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC;IACnC,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,SAAS;IAClB,aAAa,EAAE,eAAe;IAC9B,cAAc,EAAE,iBAAiB;IACjC,GAAG,EAAE,UAAU;IACf,WAAW,EAAE,sBAAsB;CAC3B,CAAC,CAAC","sourcesContent":["/**\n * Type-level registries. Users and plugins augment them through the package entry, e.g.\n * `declare module 'crypto-aio' { interface ChainRegistry { ethereum: {...} } }`, and plugins\n * inside this package augment the entry module (`declare module '../index'`). Never augment\n * this file directly: an augmentation here and one through the entry are then merged in file\n * order, and a user's chains can be lost.\n */\nexport interface ChainRegistry {}\nexport interface FamilyRegistry {}\nexport interface NativeClientMap {}\n\nexport type ChainId = Extract<keyof ChainRegistry, string>;\n\ntype ChainEntry<C extends ChainId> = ChainRegistry[C] extends {\n  family: string;\n  network: string;\n}\n  ? ChainRegistry[C]\n  : never;\n\nexport type NetworkOf<C extends ChainId> = ChainEntry<C>['network'];\nexport type FamilyOf<C extends ChainId> = ChainEntry<C>['family'];\nexport type LibraryOf<C extends ChainId> =\n  FamilyOf<C> extends keyof FamilyRegistry\n    ? FamilyRegistry[FamilyOf<C>] extends { library: infer L }\n      ? L\n      : string\n    : string;\nexport type ExtOf<C extends ChainId> =\n  FamilyOf<C> extends keyof FamilyRegistry\n    ? FamilyRegistry[FamilyOf<C>] extends { ext: infer E }\n      ? E\n      : unknown\n    : unknown;\n\nexport const Library = Object.freeze({\n  ETHERS: 'ethers',\n  WEB3: 'web3',\n  TRONWEB: 'tronweb',\n  BITCOINJS_LIB: 'bitcoinjs-lib',\n  SOLANA_WEB3_JS: '@solana/web3.js',\n  TON: '@ton/ton',\n  AVALANCHEJS: '@avalabs/avalanchejs',\n} as const);\n\nexport type KnownLibrary = (typeof Library)[keyof typeof Library];\n"]}

package/dist/core/model/intent.d.ts

@@ -0,0 +1,63 @@
+import type { Address } from './address';
+import type { Amount, AmountInput } from './amount';
+import type { AssetId, AssetInfo, AssetRef } from './asset';
+import type { FeeOverride, FeeSpeed } from './fee';
+export interface TransferOutputInput {
+    readonly to: string;
+    readonly amount: AmountInput;
+}
+export interface TransferIntent {
+    readonly to?: string;
+    readonly amount?: AmountInput;
+    readonly outputs?: readonly TransferOutputInput[];
+    /** `'native'`, a token ref, an asset id, or an alias registered for this chain/network. */
+    readonly asset?: AssetRef | string;
+    readonly from?: string;
+    readonly memo?: string;
+    readonly fee?: FeeSpeed | FeeOverride;
+}
+export interface NormalizedOutput {
+    readonly to: Address;
+    readonly amount: Amount;
+}
+export interface NormalizedIntent {
+    readonly asset: AssetInfo;
+    readonly outputs: readonly NormalizedOutput[];
+    readonly from: Address;
+    readonly memo?: string;
+    readonly fee: FeeSpeed | FeeOverride;
+}
+/**
+ * One output as drivers receive it. `variant` is the recipient address's chain-specific
+ * meaning (`Address.variant`), present only when its chain has one, e.g. TON's
+ * `bounceable` flag (the intent's `to` variant decides bounce behaviour).
+ */
+export interface DriverOutput {
+    readonly to: string;
+    readonly amount: bigint;
+    readonly variant?: Readonly<Record<string, unknown>>;
+}
+/** What drivers receive: canonical strings and base units only. */
+export interface DriverIntent {
+    readonly asset: AssetRef;
+    readonly outputs: readonly DriverOutput[];
+    readonly from: string;
+    readonly memo?: string;
+    readonly fee: FeeSpeed | FeeOverride;
+}
+export interface StoredIntent extends DriverIntent {
+    readonly assetId: AssetId;
+}
+export interface IntentSummary {
+    readonly asset: AssetId;
+    readonly outputs: readonly {
+        readonly to: string;
+        readonly amount: string;
+    }[];
+    readonly memo?: string;
+}
+export declare function collectOutputs(intent: TransferIntent): readonly TransferOutputInput[];
+export declare function toStoredIntent(intent: NormalizedIntent): StoredIntent;
+export declare function summarizeIntent(intent: StoredIntent): IntentSummary;
+/** Stable hash of the normalized intent: equal intents in different input forms collide. */
+export declare function intentHash(chain: string, network: string, intent: StoredIntent): string;

package/dist/core/model/intent.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.collectOutputs = collectOutputs;
+exports.toStoredIntent = toStoredIntent;
+exports.summarizeIntent = summarizeIntent;
+exports.intentHash = intentHash;
+const error_1 = require("../errors/error");
+const json_1 = require("../util/json");
+function collectOutputs(intent) {
+    const shorthand = intent.to !== undefined || intent.amount !== undefined;
+    if (shorthand && intent.outputs !== undefined) {
+        throw new error_1.ValidationError('INVALID_INTENT', 'use either { to, amount } or outputs, not both');
+    }
+    if (shorthand) {
+        if (intent.to === undefined || intent.amount === undefined) {
+            throw new error_1.ValidationError('INVALID_INTENT', 'both to and amount are required');
+        }
+        return [{ to: intent.to, amount: intent.amount }];
+    }
+    if (!intent.outputs || intent.outputs.length === 0) {
+        throw new error_1.ValidationError('INVALID_INTENT', 'at least one output is required');
+    }
+    return intent.outputs;
+}
+function toStoredIntent(intent) {
+    return {
+        assetId: intent.asset.id,
+        asset: intent.asset.ref,
+        // A variant is kept (and so hashed) only when the address has one, so intents of
+        // chains without variants hash exactly as before. An empty variant is none.
+        outputs: intent.outputs.map((o) => {
+            const variant = o.to.variant ? plainVariant(o.to.variant) : undefined;
+            return {
+                to: o.to.canonical,
+                amount: o.amount.base,
+                ...(variant && Object.keys(variant).length > 0 ? { variant } : {}),
+            };
+        }),
+        from: intent.from.canonical,
+        ...(intent.memo !== undefined ? { memo: intent.memo } : {}),
+        fee: intent.fee,
+    };
+}
+function summarizeIntent(intent) {
+    return {
+        asset: intent.assetId,
+        outputs: intent.outputs.map((o) => ({ to: o.to, amount: o.amount.toString() })),
+        ...(intent.memo !== undefined ? { memo: intent.memo } : {}),
+    };
+}
+/** Stable hash of the normalized intent: equal intents in different input forms collide. */
+function intentHash(chain, network, intent) {
+    return (0, json_1.sha256Hex)((0, json_1.canonicalJson)({
+        v: 1,
+        chain,
+        network,
+        asset: intent.assetId,
+        outputs: intent.outputs,
+        from: intent.from,
+        memo: intent.memo ?? null,
+        fee: intent.fee,
+    }));
+}
+/**
+ * A copy of an address variant that holds plain JSON values only (strings, finite
+ * numbers, booleans, null) under string keys, so the stored intent stays plain data
+ * and hashes stably. A symbol key is refused: the hash would not see it. The
+ * message names no address.
+ */
+function plainVariant(variant) {
+    const plain = Object.getOwnPropertySymbols(variant).length === 0 &&
+        Object.values(variant).every((value) => value === null ||
+            typeof value === 'string' ||
+            typeof value === 'boolean' ||
+            (typeof value === 'number' && Number.isFinite(value)));
+    if (!plain) {
+        throw new error_1.ValidationError('INVALID_ADDRESS', 'an address variant may hold only string keys with strings, finite numbers, booleans or null');
+    }
+    return { ...variant };
+}
+//# sourceMappingURL=intent.js.map

package/dist/core/model/intent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent.js","sourceRoot":"","sources":["../../../src/core/model/intent.ts"],"names":[],"mappings":"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","sourcesContent":["import { ValidationError } from '../errors/error';\nimport { canonicalJson, sha256Hex } from '../util/json';\nimport type { Address } from './address';\nimport type { Amount, AmountInput } from './amount';\nimport type { AssetId, AssetInfo, AssetRef } from './asset';\nimport type { FeeOverride, FeeSpeed } from './fee';\n\nexport interface TransferOutputInput {\n  readonly to: string;\n  readonly amount: AmountInput;\n}\n\nexport interface TransferIntent {\n  readonly to?: string;\n  readonly amount?: AmountInput;\n  readonly outputs?: readonly TransferOutputInput[];\n  /** `'native'`, a token ref, an asset id, or an alias registered for this chain/network. */\n  readonly asset?: AssetRef | string;\n  readonly from?: string;\n  readonly memo?: string;\n  readonly fee?: FeeSpeed | FeeOverride;\n}\n\nexport interface NormalizedOutput {\n  readonly to: Address;\n  readonly amount: Amount;\n}\n\nexport interface NormalizedIntent {\n  readonly asset: AssetInfo;\n  readonly outputs: readonly NormalizedOutput[];\n  readonly from: Address;\n  readonly memo?: string;\n  readonly fee: FeeSpeed | FeeOverride;\n}\n\n/**\n * One output as drivers receive it. `variant` is the recipient address's chain-specific\n * meaning (`Address.variant`), present only when its chain has one, e.g. TON's\n * `bounceable` flag (the intent's `to` variant decides bounce behaviour).\n */\nexport interface DriverOutput {\n  readonly to: string;\n  readonly amount: bigint;\n  readonly variant?: Readonly<Record<string, unknown>>;\n}\n\n/** What drivers receive: canonical strings and base units only. */\nexport interface DriverIntent {\n  readonly asset: AssetRef;\n  readonly outputs: readonly DriverOutput[];\n  readonly from: string;\n  readonly memo?: string;\n  readonly fee: FeeSpeed | FeeOverride;\n}\n\nexport interface StoredIntent extends DriverIntent {\n  readonly assetId: AssetId;\n}\n\nexport interface IntentSummary {\n  readonly asset: AssetId;\n  readonly outputs: readonly { readonly to: string; readonly amount: string }[];\n  readonly memo?: string;\n}\n\nexport function collectOutputs(intent: TransferIntent): readonly TransferOutputInput[] {\n  const shorthand = intent.to !== undefined || intent.amount !== undefined;\n  if (shorthand && intent.outputs !== undefined) {\n    throw new ValidationError(\n      'INVALID_INTENT',\n      'use either { to, amount } or outputs, not both',\n    );\n  }\n  if (shorthand) {\n    if (intent.to === undefined || intent.amount === undefined) {\n      throw new ValidationError('INVALID_INTENT', 'both to and amount are required');\n    }\n    return [{ to: intent.to, amount: intent.amount }];\n  }\n  if (!intent.outputs || intent.outputs.length === 0) {\n    throw new ValidationError('INVALID_INTENT', 'at least one output is required');\n  }\n  return intent.outputs;\n}\n\nexport function toStoredIntent(intent: NormalizedIntent): StoredIntent {\n  return {\n    assetId: intent.asset.id,\n    asset: intent.asset.ref,\n    // A variant is kept (and so hashed) only when the address has one, so intents of\n    // chains without variants hash exactly as before. An empty variant is none.\n    outputs: intent.outputs.map((o) => {\n      const variant = o.to.variant ? plainVariant(o.to.variant) : undefined;\n      return {\n        to: o.to.canonical,\n        amount: o.amount.base,\n        ...(variant && Object.keys(variant).length > 0 ? { variant } : {}),\n      };\n    }),\n    from: intent.from.canonical,\n    ...(intent.memo !== undefined ? { memo: intent.memo } : {}),\n    fee: intent.fee,\n  };\n}\n\nexport function summarizeIntent(intent: StoredIntent): IntentSummary {\n  return {\n    asset: intent.assetId,\n    outputs: intent.outputs.map((o) => ({ to: o.to, amount: o.amount.toString() })),\n    ...(intent.memo !== undefined ? { memo: intent.memo } : {}),\n  };\n}\n\n/** Stable hash of the normalized intent: equal intents in different input forms collide. */\nexport function intentHash(chain: string, network: string, intent: StoredIntent): string {\n  return sha256Hex(\n    canonicalJson({\n      v: 1,\n      chain,\n      network,\n      asset: intent.assetId,\n      outputs: intent.outputs,\n      from: intent.from,\n      memo: intent.memo ?? null,\n      fee: intent.fee,\n    }),\n  );\n}\n\n/**\n * A copy of an address variant that holds plain JSON values only (strings, finite\n * numbers, booleans, null) under string keys, so the stored intent stays plain data\n * and hashes stably. A symbol key is refused: the hash would not see it. The\n * message names no address.\n */\nfunction plainVariant(\n  variant: Readonly<Record<string, unknown>>,\n): Record<string, unknown> {\n  const plain =\n    Object.getOwnPropertySymbols(variant).length === 0 &&\n    Object.values(variant).every(\n      (value) =>\n        value === null ||\n        typeof value === 'string' ||\n        typeof value === 'boolean' ||\n        (typeof value === 'number' && Number.isFinite(value)),\n    );\n  if (!plain) {\n    throw new ValidationError(\n      'INVALID_ADDRESS',\n      'an address variant may hold only string keys with strings, finite numbers, booleans or null',\n    );\n  }\n  return { ...variant };\n}\n"]}

package/dist/core/model/ordering.d.ts

@@ -0,0 +1,20 @@
+export type OrderingKind = 'nonce' | 'seqno' | 'inputs' | 'expiry';
+export type OrderingData = {
+    readonly kind: 'nonce';
+    readonly nonce: bigint;
+} | {
+    readonly kind: 'seqno';
+    readonly seqno: bigint;
+    readonly validUntil: number;
+} | {
+    readonly kind: 'inputs';
+    readonly inputs: readonly string[];
+} | {
+    readonly kind: 'expiry';
+    readonly lastValidHeight?: bigint;
+    readonly expiresAtMs?: number;
+};
+/** True when at most one of two transactions with these orderings can ever be included. */
+export declare function mutuallyExclusive(a: OrderingData, b: OrderingData): boolean;
+/** Short label safe for events and logs (never lists inputs or addresses). */
+export declare function orderingLabel(ordering: OrderingData): string;

package/dist/core/model/ordering.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mutuallyExclusive = mutuallyExclusive;
+exports.orderingLabel = orderingLabel;
+/** True when at most one of two transactions with these orderings can ever be included. */
+function mutuallyExclusive(a, b) {
+    if (a.kind === 'nonce' && b.kind === 'nonce')
+        return a.nonce === b.nonce;
+    if (a.kind === 'seqno' && b.kind === 'seqno')
+        return a.seqno === b.seqno;
+    if (a.kind === 'inputs' && b.kind === 'inputs') {
+        return a.inputs.some((input) => b.inputs.includes(input));
+    }
+    return false;
+}
+/** Short label safe for events and logs (never lists inputs or addresses). */
+function orderingLabel(ordering) {
+    switch (ordering.kind) {
+        case 'nonce':
+            return `nonce:${ordering.nonce}`;
+        case 'seqno':
+            return `seqno:${ordering.seqno}`;
+        case 'inputs':
+            return `inputs:${ordering.inputs.length}`;
+        case 'expiry':
+            return 'expiry';
+    }
+}
+//# sourceMappingURL=ordering.js.map

package/dist/core/model/ordering.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ordering.js","sourceRoot":"","sources":["../../../src/core/model/ordering.ts"],"names":[],"mappings":";;AAaA,8CAOC;AAGD,sCAWC;AAtBD,2FAA2F;AAC3F,SAAgB,iBAAiB,CAAC,CAAe,EAAE,CAAe;IAChE,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK,CAAC;IACzE,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK,CAAC;IACzE,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC/C,OAAO,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,8EAA8E;AAC9E,SAAgB,aAAa,CAAC,QAAsB;IAClD,QAAQ,QAAQ,CAAC,IAAI,EAAE,CAAC;QACtB,KAAK,OAAO;YACV,OAAO,SAAS,QAAQ,CAAC,KAAK,EAAE,CAAC;QACnC,KAAK,OAAO;YACV,OAAO,SAAS,QAAQ,CAAC,KAAK,EAAE,CAAC;QACnC,KAAK,QAAQ;YACX,OAAO,UAAU,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QAC5C,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC;IACpB,CAAC;AACH,CAAC","sourcesContent":["export type OrderingKind = 'nonce' | 'seqno' | 'inputs' | 'expiry';\n\nexport type OrderingData =\n  | { readonly kind: 'nonce'; readonly nonce: bigint }\n  | { readonly kind: 'seqno'; readonly seqno: bigint; readonly validUntil: number }\n  | { readonly kind: 'inputs'; readonly inputs: readonly string[] }\n  | {\n      readonly kind: 'expiry';\n      readonly lastValidHeight?: bigint;\n      readonly expiresAtMs?: number;\n    };\n\n/** True when at most one of two transactions with these orderings can ever be included. */\nexport function mutuallyExclusive(a: OrderingData, b: OrderingData): boolean {\n  if (a.kind === 'nonce' && b.kind === 'nonce') return a.nonce === b.nonce;\n  if (a.kind === 'seqno' && b.kind === 'seqno') return a.seqno === b.seqno;\n  if (a.kind === 'inputs' && b.kind === 'inputs') {\n    return a.inputs.some((input) => b.inputs.includes(input));\n  }\n  return false;\n}\n\n/** Short label safe for events and logs (never lists inputs or addresses). */\nexport function orderingLabel(ordering: OrderingData): string {\n  switch (ordering.kind) {\n    case 'nonce':\n      return `nonce:${ordering.nonce}`;\n    case 'seqno':\n      return `seqno:${ordering.seqno}`;\n    case 'inputs':\n      return `inputs:${ordering.inputs.length}`;\n    case 'expiry':\n      return 'expiry';\n  }\n}\n"]}

package/dist/core/model/transaction.d.ts

@@ -0,0 +1,116 @@
+import type { ErrorCode } from '../errors/codes';
+import type { SigningRequest } from '../signing/types';
+import type { Address } from './address';
+import type { Amount } from './amount';
+import type { AssetInfo, AssetRef } from './asset';
+import type { FeeEstimateDraft } from './fee';
+import type { IntentSummary } from './intent';
+import type { OrderingData } from './ordering';
+/** Protocol data only (bytes or protocol JSON), never SDK objects. */
+export interface RawTx {
+    readonly encoding: 'hex' | 'base64' | 'json';
+    readonly data: string;
+}
+export type AttemptIdKind = 'tx-hash' | 'txid' | 'signature' | 'message-hash';
+/** Identity of a signed payload. `canonical: false` = not the final protocol tx hash (TON). */
+export interface AttemptRef {
+    readonly id: string;
+    readonly idKind: AttemptIdKind;
+    readonly canonical: boolean;
+}
+export type TxState = 'unknown' | 'pending' | 'mempool' | 'included' | 'final' | 'failed' | 'dropped' | 'replaced' | 'expired' | 'refused' | 'rejected';
+export type Evidence = 'observed' | 'proven';
+export type Finality = 'none' | 'probabilistic' | 'final';
+export interface TxStatus {
+    readonly state: TxState;
+    readonly evidence: Evidence;
+    readonly confirmations: number;
+    readonly txHash?: string;
+    readonly blockHash?: string;
+    readonly blockHeight?: bigint;
+    readonly finality: Finality;
+    /**
+     * Why the transaction did not go through. Present only with `failed`, `refused` or
+     * `rejected`. It is either a broadcast's refusal or rejection text, or the chain
+     * driver's text for an on-chain failure. It is a short, fixed text with no addresses,
+     * amounts or node detail. It is `sensitive` data, so it never appears in events
+     * or logs.
+     */
+    readonly reason?: string;
+    readonly replacedBy?: string;
+}
+export interface BlockRef {
+    readonly height: bigint;
+    readonly hash: string;
+    readonly timestamp?: number;
+}
+export interface Block {
+    readonly height: bigint;
+    readonly hash: string;
+    readonly parentHash: string;
+    readonly timestamp?: number;
+    readonly transactionIds?: readonly string[];
+}
+export type TransferSource = 'native' | 'token-event' | 'internal';
+interface TransferBase {
+    /** Deterministic: `${txId}:${locator}`. */
+    readonly id: string;
+    readonly from: readonly Address[];
+    readonly to: Address;
+    readonly source: TransferSource;
+    readonly memo?: string;
+}
+/** A transfer whose asset resolved on this chain and network. */
+export interface ResolvedTransfer extends TransferBase {
+    readonly asset: AssetInfo;
+    readonly amount: Amount;
+    readonly unresolved?: undefined;
+}
+/**
+ * A transfer whose asset could not be resolved, for example a token with unusable
+ * metadata or a failing decimals call. It has no `asset` and no `amount`: without the
+ * asset's decimals there is no `Amount`. `unresolved` keeps the chain's raw data instead,
+ * and the transaction's `decoding` is `'partial'`. A read never fails on such a transfer;
+ * only a retryable failure fails the read, so it can be retried.
+ */
+export interface UnresolvedTransfer extends TransferBase {
+    readonly asset?: undefined;
+    readonly amount?: undefined;
+    readonly unresolved: {
+        /** The asset as the chain names it. */
+        readonly asset: AssetRef;
+        /** The amount in base units, never scaled. */
+        readonly amount: bigint;
+        /** Why the asset did not resolve, e.g. `ASSET_RESOLUTION`. */
+        readonly code: ErrorCode;
+    };
+}
+/** Check `unresolved` (or `amount`) before using a transfer's `asset` and `amount`. */
+export type Transfer = ResolvedTransfer | UnresolvedTransfer;
+export type Decoding = 'complete' | 'partial' | 'none';
+export interface Transaction {
+    readonly id: string;
+    readonly chain: string;
+    readonly network: string;
+    readonly status: TxStatus;
+    readonly block?: BlockRef;
+    readonly fee?: readonly Amount[];
+    readonly transfers: readonly Transfer[];
+    readonly decoding: Decoding;
+    readonly raw?: RawTx;
+    readonly details: Readonly<Record<string, unknown>>;
+}
+export interface UnsignedTx {
+    readonly payload: RawTx;
+    /** Only when identity is fixed before signing (Tron; UTXO with witness-only inputs). */
+    readonly expectedRef?: AttemptRef;
+    readonly signingRequests: readonly SigningRequest[];
+    readonly ordering: OrderingData;
+    readonly fee: FeeEstimateDraft;
+    readonly summary: IntentSummary;
+}
+export interface SignedTx {
+    readonly raw: RawTx;
+    readonly ref: AttemptRef;
+}
+export {};

package/dist/core/model/transaction.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=transaction.js.map