crypto-aio 0.0.3 → 0.1.0

package/dist/adapters/avalanche/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `crypto-aio/avalanche`: the SDK-free Avalanche types, the family's peer dependency and
+ * capabilities, and the `crypto-aio/native` client type: importing this entry types
+ * `native(bc, '@avalabs/avalanchejs')` as an {@link AvalancheNativeClient}.
+ *
+ * @module crypto-aio/avalanche
+ */
+import type { AvalancheNativeClient } from './driver';
+declare module '../../index' {
+    interface NativeClientMap {
+        '@avalabs/avalanchejs': AvalancheNativeClient;
+    }
+}
+export type { AvalancheNativeClient } from './driver';
+export { AVALANCHE_PEER_DEPENDENCIES } from './plugin';
+export { AVALANCHE_CAPABILITIES } from './network';
+/** The part of `@avalabs/avalanchejs` this library uses, as the native client types it. */
+export type { AvalancheSdk, SdkAddress, SdkBaseTx, SdkBigInt, SdkContext, SdkCredential, SdkDimensions, SdkFeeState, SdkId, SdkInt, SdkManager, SdkOutputOwners, SdkSerializable, SdkSignature, SdkSignedTx, SdkTransaction, SdkTransferOutput, SdkTransferableInput, SdkTransferableOutput, SdkUnpacker, SdkUnsignedTx, SdkUtxo, SdkUtxoId, } from './sdk';
+export type { AvalancheExt, AvalancheFeeDetails, AvalancheFeeOverride, AvalancheUnspent, AvalancheVm, } from './types';

package/dist/adapters/avalanche/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AVALANCHE_CAPABILITIES = exports.AVALANCHE_PEER_DEPENDENCIES = void 0;
+var plugin_1 = require("./plugin");
+Object.defineProperty(exports, "AVALANCHE_PEER_DEPENDENCIES", { enumerable: true, get: function () { return plugin_1.AVALANCHE_PEER_DEPENDENCIES; } });
+var network_1 = require("./network");
+Object.defineProperty(exports, "AVALANCHE_CAPABILITIES", { enumerable: true, get: function () { return network_1.AVALANCHE_CAPABILITIES; } });
+//# sourceMappingURL=index.js.map

package/dist/adapters/avalanche/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/avalanche/index.ts"],"names":[],"mappings":";;;AAkBA,mCAAuD;AAA9C,qHAAA,2BAA2B,OAAA;AACpC,qCAAmD;AAA1C,iHAAA,sBAAsB,OAAA","sourcesContent":["/**\n * `crypto-aio/avalanche`: the SDK-free Avalanche types, the family's peer dependency and\n * capabilities, and the `crypto-aio/native` client type: importing this entry types\n * `native(bc, '@avalabs/avalanchejs')` as an {@link AvalancheNativeClient}.\n *\n * @module crypto-aio/avalanche\n */\nimport type { AvalancheNativeClient } from './driver';\n\n// Through the package entry, as a user's own augmentation does, so the two merge in any\n// file order. SDK types appear only here, so the main entry needs no SDK to type-check.\ndeclare module '../../index' {\n  interface NativeClientMap {\n    '@avalabs/avalanchejs': AvalancheNativeClient;\n  }\n}\n\nexport type { AvalancheNativeClient } from './driver';\nexport { AVALANCHE_PEER_DEPENDENCIES } from './plugin';\nexport { AVALANCHE_CAPABILITIES } from './network';\n/** The part of `@avalabs/avalanchejs` this library uses, as the native client types it. */\nexport type {\n  AvalancheSdk,\n  SdkAddress,\n  SdkBaseTx,\n  SdkBigInt,\n  SdkContext,\n  SdkCredential,\n  SdkDimensions,\n  SdkFeeState,\n  SdkId,\n  SdkInt,\n  SdkManager,\n  SdkOutputOwners,\n  SdkSerializable,\n  SdkSignature,\n  SdkSignedTx,\n  SdkTransaction,\n  SdkTransferOutput,\n  SdkTransferableInput,\n  SdkTransferableOutput,\n  SdkUnpacker,\n  SdkUnsignedTx,\n  SdkUtxo,\n  SdkUtxoId,\n} from './sdk';\nexport type {\n  AvalancheExt,\n  AvalancheFeeDetails,\n  AvalancheFeeOverride,\n  AvalancheUnspent,\n  AvalancheVm,\n} from './types';\n"]}

package/dist/adapters/avalanche/network.d.ts

@@ -0,0 +1,37 @@
+import { type Capability } from '../../core/model/capability';
+import type { ChainInfo, NetworkInfo } from '../../core/model/chain';
+import type { AvalancheVm } from './types';
+/**
+ * Every capability of an Avalanche network. The Data API indexer is required: it locates
+ * a transaction's block and serves address history.
+ */
+export declare const AVALANCHE_CAPABILITIES: readonly Capability[];
+export interface AvalancheNetworkConfig {
+    readonly vm: AvalancheVm;
+    /** The chain alias addresses carry: `X` or `P`. */
+    readonly alias: 'X' | 'P';
+    readonly networkId: number;
+    /** The bech32 human-readable part of addresses: `avax`, `fuji`. */
+    readonly hrp: string;
+    /** The chain's own id (CB58), written into every transaction. */
+    readonly blockchainId: string;
+    readonly avaxAssetId: string;
+    /**
+     * The id of the block at height 0: the endpoint identity. An endpoint whose identity
+     * probe reports another id serves another network or chain, and is disabled.
+     */
+    readonly genesisBlockId: string;
+    /** Finality depth N: a block with N confirmations is final. */
+    readonly confirmations: number;
+    /** Absurd-fee guard: the highest fee (nAVAX) a transfer ever pays. */
+    readonly maxFee: bigint;
+    /** P-Chain: above this gas price (nAVAX per gas) an endpoint's fee state decides nothing. */
+    readonly maxGasPrice: bigint;
+    readonly capabilities: ReadonlySet<Capability>;
+}
+/** Library defaults for the handle `options`. */
+export declare const OPTION_DEFAULTS: Readonly<{
+    maxFee: 100000000n;
+    maxGasPrice: 10000n;
+}>;
+export declare function avalancheNetworkConfig(chain: ChainInfo, network: NetworkInfo, options?: Readonly<Record<string, unknown>>): AvalancheNetworkConfig;

package/dist/adapters/avalanche/network.js

@@ -0,0 +1,135 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OPTION_DEFAULTS = exports.AVALANCHE_CAPABILITIES = void 0;
+exports.avalancheNetworkConfig = avalancheNetworkConfig;
+/**
+ * What the Avalanche driver needs from a network's registry entry and from the handle's
+ * `options`, validated once when a driver is created, so bad data fails with
+ * `CONFIG_INVALID` instead of misbehaving: every number is checked, and a confirmation
+ * count must be a safe integer of at least 1.
+ * SDK-free.
+ */
+const error_1 = require("../../core/errors/error");
+const capability_1 = require("../../core/model/capability");
+const names_1 = require("../../core/util/names");
+const cb58_1 = require("./cb58");
+/**
+ * Every capability of an Avalanche network. The Data API indexer is required: it locates
+ * a transaction's block and serves address history.
+ */
+exports.AVALANCHE_CAPABILITIES = Object.freeze([
+    'batch-transfer',
+    'memo',
+    'block-scan',
+    'address-history',
+    'hd-public-derivation',
+]);
+/** Library defaults for the handle `options`. */
+exports.OPTION_DEFAULTS = Object.freeze({
+    maxFee: 100000000n, // 0.1 AVAX
+    maxGasPrice: 10000n, // 10,000 × the P-Chain's minimum price
+});
+const OPTION_KEYS = new Set(Object.keys(exports.OPTION_DEFAULTS));
+/**
+ * A network's capability overrides, checked against what the driver serves. The handle
+ * advertises the manifest's capabilities plus `add`, minus `remove`, and the core accepts
+ * what it advertises, so each name must be one the driver serves: otherwise the core
+ * accepts a request the driver cannot serve. The error names a library capability, never
+ * a caller's unknown text.
+ */
+function checkCapabilities(network, fail) {
+    const add = network.capabilities?.add ?? [];
+    const remove = network.capabilities?.remove ?? [];
+    if (!Array.isArray(add) || !Array.isArray(remove)) {
+        fail('capabilities.add and capabilities.remove must be lists');
+    }
+    const serves = `the Avalanche driver serves ${exports.AVALANCHE_CAPABILITIES.join(', ')}`;
+    for (const [side, names] of [
+        ['add', add],
+        ['remove', remove],
+    ]) {
+        for (const name of names) {
+            if (exports.AVALANCHE_CAPABILITIES.includes(name))
+                continue;
+            const known = capability_1.KNOWN_CAPABILITIES.includes(name);
+            fail(`capabilities.${side}: ${known ? `'${String(name)}' is not one` : 'an unknown name'}; ${serves}`);
+        }
+    }
+}
+function avalancheNetworkConfig(chain, network, options = {}) {
+    const fail = (reason) => {
+        throw new error_1.ConfigError('CONFIG_INVALID', `Avalanche network ${chain.id}:${network.id}: ${reason}`);
+    };
+    const params = network.params ?? {};
+    const vm = params.vm;
+    if (vm !== 'avm' && vm !== 'pvm')
+        fail(`params.vm must be 'avm' or 'pvm'`);
+    const alias = params.alias;
+    if (alias !== (vm === 'avm' ? 'X' : 'P')) {
+        fail(`params.alias must be '${vm === 'avm' ? 'X' : 'P'}' for the ${vm} chain`);
+    }
+    const expectedFee = vm === 'avm' ? 'avalanche-static' : 'avalanche-dynamic';
+    if (network.feeModel !== expectedFee) {
+        fail(`fee model '${network.feeModel}' is not '${expectedFee}'`);
+    }
+    const networkId = params.networkId;
+    if (!Number.isSafeInteger(networkId) ||
+        networkId < 1 ||
+        networkId > 0xffffffff) {
+        fail('params.networkId must be an integer from 1 to 2^32 - 1');
+    }
+    const hrp = params.hrp;
+    // 83 is bech32's limit; an address of 20 bytes then still fits in 90 characters.
+    if (typeof hrp !== 'string' || !/^[a-z]{1,40}$/.test(hrp)) {
+        fail('params.hrp must be a lowercase human-readable part of 1 to 40 letters');
+    }
+    for (const key of ['blockchainId', 'avaxAssetId']) {
+        if (!(0, cb58_1.isId)(params[key]))
+            fail(`params.${key} must be a CB58 id of 32 bytes`);
+    }
+    if (!(0, cb58_1.isId)(network.identity)) {
+        fail('its identity must be the CB58 id of the block at height 0');
+    }
+    const finality = network.finality;
+    if (finality.kind !== 'confirmations') {
+        fail(`finality '${finality.kind}' is not an Avalanche policy (use 'confirmations')`);
+    }
+    const confirmations = finality.confirmations;
+    if (!Number.isSafeInteger(confirmations) || confirmations < 1) {
+        fail('finality.confirmations must be a safe integer >= 1');
+    }
+    for (const key of Object.keys(options)) {
+        // The accepted names, never the caller's key (it may be a pasted secret).
+        if (!OPTION_KEYS.has(key))
+            fail((0, names_1.unknownName)('option', OPTION_KEYS));
+    }
+    const merged = { ...exports.OPTION_DEFAULTS, ...options };
+    const positive = (key) => {
+        const value = merged[key];
+        if (typeof value !== 'bigint' || value < 1n)
+            fail(`options.${key} must be a bigint >= 1`);
+        return value;
+    };
+    const maxFee = positive('maxFee');
+    const maxGasPrice = positive('maxGasPrice');
+    checkCapabilities(network, fail);
+    const capabilities = new Set(exports.AVALANCHE_CAPABILITIES);
+    for (const c of network.capabilities?.add ?? [])
+        capabilities.add(c);
+    for (const c of network.capabilities?.remove ?? [])
+        capabilities.delete(c);
+    return {
+        vm: vm,
+        alias: alias,
+        networkId: networkId,
+        hrp: hrp,
+        blockchainId: params.blockchainId,
+        avaxAssetId: params.avaxAssetId,
+        genesisBlockId: network.identity,
+        confirmations: confirmations,
+        maxFee,
+        maxGasPrice,
+        capabilities,
+    };
+}
+//# sourceMappingURL=network.js.map

package/dist/adapters/avalanche/network.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.js","sourceRoot":"","sources":["../../../src/adapters/avalanche/network.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * What the Avalanche driver needs from a network's registry entry and from the handle's\n * `options`, validated once when a driver is created, so bad data fails with\n * `CONFIG_INVALID` instead of misbehaving: every number is checked, and a confirmation\n * count must be a safe integer of at least 1.\n * SDK-free.\n */\nimport { ConfigError } from '../../core/errors/error';\nimport { KNOWN_CAPABILITIES, type Capability } from '../../core/model/capability';\nimport type { ChainInfo, NetworkInfo } from '../../core/model/chain';\nimport { unknownName } from '../../core/util/names';\nimport { isId } from './cb58';\nimport type { AvalancheVm } from './types';\n\n/**\n * Every capability of an Avalanche network. The Data API indexer is required: it locates\n * a transaction's block and serves address history.\n */\nexport const AVALANCHE_CAPABILITIES: readonly Capability[] = Object.freeze([\n  'batch-transfer',\n  'memo',\n  'block-scan',\n  'address-history',\n  'hd-public-derivation',\n]);\n\nexport interface AvalancheNetworkConfig {\n  readonly vm: AvalancheVm;\n  /** The chain alias addresses carry: `X` or `P`. */\n  readonly alias: 'X' | 'P';\n  readonly networkId: number;\n  /** The bech32 human-readable part of addresses: `avax`, `fuji`. */\n  readonly hrp: string;\n  /** The chain's own id (CB58), written into every transaction. */\n  readonly blockchainId: string;\n  readonly avaxAssetId: string;\n  /**\n   * The id of the block at height 0: the endpoint identity. An endpoint whose identity\n   * probe reports another id serves another network or chain, and is disabled.\n   */\n  readonly genesisBlockId: string;\n  /** Finality depth N: a block with N confirmations is final. */\n  readonly confirmations: number;\n  /** Absurd-fee guard: the highest fee (nAVAX) a transfer ever pays. */\n  readonly maxFee: bigint;\n  /** P-Chain: above this gas price (nAVAX per gas) an endpoint's fee state decides nothing. */\n  readonly maxGasPrice: bigint;\n  readonly capabilities: ReadonlySet<Capability>;\n}\n\n/** Library defaults for the handle `options`. */\nexport const OPTION_DEFAULTS = Object.freeze({\n  maxFee: 100_000_000n, // 0.1 AVAX\n  maxGasPrice: 10_000n, // 10,000 × the P-Chain's minimum price\n});\n\nconst OPTION_KEYS = new Set(Object.keys(OPTION_DEFAULTS));\n\n/**\n * A network's capability overrides, checked against what the driver serves. The handle\n * advertises the manifest's capabilities plus `add`, minus `remove`, and the core accepts\n * what it advertises, so each name must be one the driver serves: otherwise the core\n * accepts a request the driver cannot serve. The error names a library capability, never\n * a caller's unknown text.\n */\nfunction checkCapabilities(network: NetworkInfo, fail: (reason: string) => never): void {\n  const add: unknown = network.capabilities?.add ?? [];\n  const remove: unknown = network.capabilities?.remove ?? [];\n  if (!Array.isArray(add) || !Array.isArray(remove)) {\n    fail('capabilities.add and capabilities.remove must be lists');\n  }\n  const serves = `the Avalanche driver serves ${AVALANCHE_CAPABILITIES.join(', ')}`;\n  for (const [side, names] of [\n    ['add', add],\n    ['remove', remove],\n  ] as const) {\n    for (const name of names as readonly unknown[]) {\n      if (AVALANCHE_CAPABILITIES.includes(name as Capability)) continue;\n      const known = (KNOWN_CAPABILITIES as readonly unknown[]).includes(name);\n      fail(\n        `capabilities.${side}: ${known ? `'${String(name)}' is not one` : 'an unknown name'}; ${serves}`,\n      );\n    }\n  }\n}\n\nexport function avalancheNetworkConfig(\n  chain: ChainInfo,\n  network: NetworkInfo,\n  options: Readonly<Record<string, unknown>> = {},\n): AvalancheNetworkConfig {\n  const fail = (reason: string): never => {\n    throw new ConfigError(\n      'CONFIG_INVALID',\n      `Avalanche network ${chain.id}:${network.id}: ${reason}`,\n    );\n  };\n  const params = network.params ?? {};\n  const vm = params.vm;\n  if (vm !== 'avm' && vm !== 'pvm') fail(`params.vm must be 'avm' or 'pvm'`);\n  const alias = params.alias;\n  if (alias !== (vm === 'avm' ? 'X' : 'P')) {\n    fail(`params.alias must be '${vm === 'avm' ? 'X' : 'P'}' for the ${vm} chain`);\n  }\n  const expectedFee = vm === 'avm' ? 'avalanche-static' : 'avalanche-dynamic';\n  if (network.feeModel !== expectedFee) {\n    fail(`fee model '${network.feeModel}' is not '${expectedFee}'`);\n  }\n  const networkId = params.networkId;\n  if (\n    !Number.isSafeInteger(networkId) ||\n    (networkId as number) < 1 ||\n    (networkId as number) > 0xffffffff\n  ) {\n    fail('params.networkId must be an integer from 1 to 2^32 - 1');\n  }\n  const hrp = params.hrp;\n  // 83 is bech32's limit; an address of 20 bytes then still fits in 90 characters.\n  if (typeof hrp !== 'string' || !/^[a-z]{1,40}$/.test(hrp)) {\n    fail('params.hrp must be a lowercase human-readable part of 1 to 40 letters');\n  }\n  for (const key of ['blockchainId', 'avaxAssetId'] as const) {\n    if (!isId(params[key])) fail(`params.${key} must be a CB58 id of 32 bytes`);\n  }\n  if (!isId(network.identity)) {\n    fail('its identity must be the CB58 id of the block at height 0');\n  }\n  const finality = network.finality;\n  if (finality.kind !== 'confirmations') {\n    fail(`finality '${finality.kind}' is not an Avalanche policy (use 'confirmations')`);\n  }\n  const confirmations = (finality as { confirmations: unknown }).confirmations;\n  if (!Number.isSafeInteger(confirmations) || (confirmations as number) < 1) {\n    fail('finality.confirmations must be a safe integer >= 1');\n  }\n\n  for (const key of Object.keys(options)) {\n    // The accepted names, never the caller's key (it may be a pasted secret).\n    if (!OPTION_KEYS.has(key)) fail(unknownName('option', OPTION_KEYS));\n  }\n  const merged: Readonly<Record<string, unknown>> = { ...OPTION_DEFAULTS, ...options };\n  const positive = (key: string): bigint => {\n    const value = merged[key];\n    if (typeof value !== 'bigint' || value < 1n)\n      fail(`options.${key} must be a bigint >= 1`);\n    return value as bigint;\n  };\n  const maxFee = positive('maxFee');\n  const maxGasPrice = positive('maxGasPrice');\n\n  checkCapabilities(network, fail);\n  const capabilities = new Set<Capability>(AVALANCHE_CAPABILITIES);\n  for (const c of network.capabilities?.add ?? []) capabilities.add(c);\n  for (const c of network.capabilities?.remove ?? []) capabilities.delete(c);\n  return {\n    vm: vm as AvalancheVm,\n    alias: alias as 'X' | 'P',\n    networkId: networkId as number,\n    hrp: hrp as string,\n    blockchainId: params.blockchainId as string,\n    avaxAssetId: params.avaxAssetId as string,\n    genesisBlockId: network.identity as string,\n    confirmations: confirmations as number,\n    maxFee,\n    maxGasPrice,\n    capabilities,\n  };\n}\n"]}

package/dist/adapters/avalanche/plugin.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The Avalanche family plugin (SDK-free): the X-Chain and P-Chain, the public and Data API
+ * presets and the avalanchejs manifest. Only `load()` pulls in the driver module and, with
+ * it, the SDK.
+ */
+import type { AdapterManifest, PeerDependency } from '../../core/driver/types';
+import type { Plugin } from '../../core/registry/plugin';
+/**
+ * The SDK version this adapter is validated against, keyed by package name: the range
+ * starts at the version the tests pin.
+ */
+export declare const AVALANCHE_PEER_DEPENDENCIES: Readonly<Record<'@avalabs/avalanchejs', PeerDependency>>;
+/**
+ * The `@avalabs/avalanchejs` manifest, built once, at module level, so every
+ * `avalanchePlugin()` carries the same `load` function. Registration compares a plugin's
+ * functions by identity: the same plugin again is a no-op, while one with another `load`
+ * under this name is `CONFIG_INVALID`.
+ */
+export declare const avalancheManifest: AdapterManifest;
+/** The built-in Avalanche family: chains `avalanche-x` and `avalanche-p`, mainnet and Fuji. */
+export declare function avalanchePlugin(): Plugin;

package/dist/adapters/avalanche/plugin.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.avalancheManifest = exports.AVALANCHE_PEER_DEPENDENCIES = void 0;
+exports.avalanchePlugin = avalanchePlugin;
+const freeze_1 = require("../../core/util/freeze");
+const chains_1 = require("./chains");
+const network_1 = require("./network");
+const presets_1 = require("./presets");
+/**
+ * The SDK version this adapter is validated against, keyed by package name: the range
+ * starts at the version the tests pin.
+ */
+exports.AVALANCHE_PEER_DEPENDENCIES = (0, freeze_1.deepFreeze)({
+    '@avalabs/avalanchejs': { name: '@avalabs/avalanchejs', range: '^5.2.0' },
+});
+/**
+ * The `@avalabs/avalanchejs` manifest, built once, at module level, so every
+ * `avalanchePlugin()` carries the same `load` function. Registration compares a plugin's
+ * functions by identity: the same plugin again is a no-op, while one with another `load`
+ * under this name is `CONFIG_INVALID`.
+ */
+exports.avalancheManifest = Object.freeze({
+    family: 'avalanche',
+    library: '@avalabs/avalanchejs',
+    chains: Object.freeze(['avalanche-x', 'avalanche-p']),
+    capabilities: network_1.AVALANCHE_CAPABILITIES,
+    // The node cannot say which block holds a transaction: the Data API locates it (the node
+    // then proves it) and serves address history.
+    requiresIndexer: true,
+    peerDependencies: Object.freeze([exports.AVALANCHE_PEER_DEPENDENCIES['@avalabs/avalanchejs']]),
+    load: async () => {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const mod = require('./driver');
+        return mod.avalancheDriverFactory;
+    },
+});
+/** The built-in Avalanche family: chains `avalanche-x` and `avalanche-p`, mainnet and Fuji. */
+function avalanchePlugin() {
+    return {
+        name: 'avalanche',
+        chains: chains_1.AVALANCHE_CHAINS,
+        adapters: [exports.avalancheManifest],
+        presets: presets_1.AVALANCHE_PRESETS,
+    };
+}
+//# sourceMappingURL=plugin.js.map

package/dist/adapters/avalanche/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../../src/adapters/avalanche/plugin.ts"],"names":[],"mappings":";;;AAiDA,0CAOC;AA7CD,mDAAoD;AACpD,qCAA4C;AAC5C,uCAAmD;AACnD,uCAA8C;AAE9C;;;GAGG;AACU,QAAA,2BAA2B,GAEpC,IAAA,mBAAU,EAAC;IACb,sBAAsB,EAAE,EAAE,IAAI,EAAE,sBAAsB,EAAE,KAAK,EAAE,QAAQ,EAAE;CAC1E,CAAC,CAAC;AAEH;;;;;GAKG;AACU,QAAA,iBAAiB,GAAoB,MAAM,CAAC,MAAM,CAAC;IAC9D,MAAM,EAAE,WAAW;IACnB,OAAO,EAAE,sBAAsB;IAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;IACrD,YAAY,EAAE,gCAAsB;IACpC,yFAAyF;IACzF,8CAA8C;IAC9C,eAAe,EAAE,IAAI;IACrB,gBAAgB,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,mCAA2B,CAAC,sBAAsB,CAAC,CAAC,CAAC;IACtF,IAAI,EAAE,KAAK,IAA4B,EAAE;QACvC,iEAAiE;QACjE,MAAM,GAAG,GAAG,OAAO,CAAC,UAAU,CAA8B,CAAC;QAC7D,OAAO,GAAG,CAAC,sBAAsB,CAAC;IACpC,CAAC;CACF,CAAC,CAAC;AAEH,+FAA+F;AAC/F,SAAgB,eAAe;IAC7B,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,MAAM,EAAE,yBAAgB;QACxB,QAAQ,EAAE,CAAC,yBAAiB,CAAC;QAC7B,OAAO,EAAE,2BAAiB;KAC3B,CAAC;AACJ,CAAC","sourcesContent":["/**\n * The Avalanche family plugin (SDK-free): the X-Chain and P-Chain, the public and Data API\n * presets and the avalanchejs manifest. Only `load()` pulls in the driver module and, with\n * it, the SDK.\n */\nimport type {\n  AdapterManifest,\n  DriverFactory,\n  PeerDependency,\n} from '../../core/driver/types';\nimport type { Plugin } from '../../core/registry/plugin';\nimport { deepFreeze } from '../../core/util/freeze';\nimport { AVALANCHE_CHAINS } from './chains';\nimport { AVALANCHE_CAPABILITIES } from './network';\nimport { AVALANCHE_PRESETS } from './presets';\n\n/**\n * The SDK version this adapter is validated against, keyed by package name: the range\n * starts at the version the tests pin.\n */\nexport const AVALANCHE_PEER_DEPENDENCIES: Readonly<\n  Record<'@avalabs/avalanchejs', PeerDependency>\n> = deepFreeze({\n  '@avalabs/avalanchejs': { name: '@avalabs/avalanchejs', range: '^5.2.0' },\n});\n\n/**\n * The `@avalabs/avalanchejs` manifest, built once, at module level, so every\n * `avalanchePlugin()` carries the same `load` function. Registration compares a plugin's\n * functions by identity: the same plugin again is a no-op, while one with another `load`\n * under this name is `CONFIG_INVALID`.\n */\nexport const avalancheManifest: AdapterManifest = Object.freeze({\n  family: 'avalanche',\n  library: '@avalabs/avalanchejs',\n  chains: Object.freeze(['avalanche-x', 'avalanche-p']),\n  capabilities: AVALANCHE_CAPABILITIES,\n  // The node cannot say which block holds a transaction: the Data API locates it (the node\n  // then proves it) and serves address history.\n  requiresIndexer: true,\n  peerDependencies: Object.freeze([AVALANCHE_PEER_DEPENDENCIES['@avalabs/avalanchejs']]),\n  load: async (): Promise<DriverFactory> => {\n    // eslint-disable-next-line @typescript-eslint/no-require-imports\n    const mod = require('./driver') as typeof import('./driver');\n    return mod.avalancheDriverFactory;\n  },\n});\n\n/** The built-in Avalanche family: chains `avalanche-x` and `avalanche-p`, mainnet and Fuji. */\nexport function avalanchePlugin(): Plugin {\n  return {\n    name: 'avalanche',\n    chains: AVALANCHE_CHAINS,\n    adapters: [avalancheManifest],\n    presets: AVALANCHE_PRESETS,\n  };\n}\n"]}

package/dist/adapters/avalanche/presets.d.ts

@@ -0,0 +1,6 @@
+import type { ProviderPreset } from '../../core/registry/providers';
+/**
+ * Built once at module level, so the plugin's functions keep their identity: registration
+ * compares functions by identity, and rebuilt ones would make the same plugin a new one.
+ */
+export declare const AVALANCHE_PRESETS: readonly ProviderPreset[];

package/dist/adapters/avalanche/presets.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AVALANCHE_PRESETS = void 0;
+/**
+ * Avalanche provider presets, verified on 2026-10-01:
+ * - `public` (`rpc`): Ava Labs' public API, `https://api.avax.network/ext/bc/{X,P}` on
+ *   mainnet and `https://api.avax-test.network/ext/bc/{X,P}` on Fuji. Each chain's JSON-RPC
+ *   endpoint is its own URL.
+ * - `public` (`indexer`): the Avalanche Data API (formerly Glacier) without a key,
+ *   `https://data-api.avax.network/v1/networks/{mainnet,fuji}/blockchains/{x-chain,p-chain}`.
+ * - `glacier` (`indexer`): the same Data API with an API key, sent in its
+ *   `x-glacier-api-key` header (the service's OpenAPI document) as a `Secret`, so it never
+ *   reaches logs, errors or events.
+ * The public services are rate limited and marked `production: false`; their limits are not
+ * published, so none is set here. For production, run your own AvalancheGo node and
+ * configure it as `{ endpoints: [{ url: 'https://node.example/ext/bc/X' }] }`.
+ */
+const error_1 = require("../../core/errors/error");
+const secret_1 = require("../../core/secret/secret");
+const freeze_1 = require("../../core/util/freeze");
+const NODES = Object.freeze({
+    mainnet: 'https://api.avax.network',
+    fuji: 'https://api.avax-test.network',
+});
+const DATA_API = 'https://data-api.avax.network/v1/networks';
+const CHAINS = Object.freeze({
+    'avalanche-x': { alias: 'X', name: 'x-chain' },
+    'avalanche-p': { alias: 'P', name: 'p-chain' },
+});
+/** Own keys only: `constructor`, `toString` or `__proto__` is not a chain or network. */
+const supports = (chain, network) => Object.hasOwn(CHAINS, chain) && Object.hasOwn(NODES, network);
+/** Unreachable through the catalog, which asks `supports` first. */
+function chainOf(input) {
+    if (!supports(input.chain, input.network)) {
+        throw new Error(`no Avalanche endpoint for ${input.chain}:${input.network}`);
+    }
+    return CHAINS[input.chain];
+}
+const nodeUrl = (input) => `${NODES[input.network]}/ext/bc/${chainOf(input).alias}`;
+const dataApiUrl = (input) => `${DATA_API}/${input.network}/blockchains/${chainOf(input).name}`;
+/** The revealed key; the error names the preset and network, never the key. */
+function apiKeyOf(input) {
+    const key = input.apiKey === undefined ? undefined : (0, secret_1.reveal)(input.apiKey);
+    if (typeof key !== 'string' || key.trim() === '') {
+        throw new error_1.ConfigError('CONFIG_INVALID', `provider preset 'glacier' requires a non-empty apiKey for ${input.chain}:${input.network}`);
+    }
+    return key;
+}
+/**
+ * Built once at module level, so the plugin's functions keep their identity: registration
+ * compares functions by identity, and rebuilt ones would make the same plugin a new one.
+ */
+exports.AVALANCHE_PRESETS = (0, freeze_1.deepFreeze)([
+    {
+        name: 'public',
+        kind: 'rpc',
+        production: false,
+        supports,
+        endpoints: (input) => [
+            { name: 'avax', url: nodeUrl(input) },
+        ],
+    },
+    {
+        name: 'public',
+        kind: 'indexer',
+        production: false,
+        supports,
+        endpoints: (input) => [
+            { name: 'data-api', url: dataApiUrl(input) },
+        ],
+    },
+    {
+        name: 'glacier',
+        kind: 'indexer',
+        requiresApiKey: true,
+        supports,
+        endpoints: (input) => [
+            {
+                name: 'data-api',
+                url: dataApiUrl(input),
+                headers: { 'x-glacier-api-key': (0, secret_1.secret)(apiKeyOf(input)) },
+            },
+        ],
+    },
+]);
+//# sourceMappingURL=presets.js.map

package/dist/adapters/avalanche/presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.js","sourceRoot":"","sources":["../../../src/adapters/avalanche/presets.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Avalanche provider presets, verified on 2026-10-01:\n * - `public` (`rpc`): Ava Labs' public API, `https://api.avax.network/ext/bc/{X,P}` on\n *   mainnet and `https://api.avax-test.network/ext/bc/{X,P}` on Fuji. Each chain's JSON-RPC\n *   endpoint is its own URL.\n * - `public` (`indexer`): the Avalanche Data API (formerly Glacier) without a key,\n *   `https://data-api.avax.network/v1/networks/{mainnet,fuji}/blockchains/{x-chain,p-chain}`.\n * - `glacier` (`indexer`): the same Data API with an API key, sent in its\n *   `x-glacier-api-key` header (the service's OpenAPI document) as a `Secret`, so it never\n *   reaches logs, errors or events.\n * The public services are rate limited and marked `production: false`; their limits are not\n * published, so none is set here. For production, run your own AvalancheGo node and\n * configure it as `{ endpoints: [{ url: 'https://node.example/ext/bc/X' }] }`.\n */\nimport { ConfigError } from '../../core/errors/error';\nimport type { PresetInput, ProviderPreset } from '../../core/registry/providers';\nimport { reveal, secret } from '../../core/secret/secret';\nimport type { EndpointConfig } from '../../core/transport/types';\nimport { deepFreeze } from '../../core/util/freeze';\n\nconst NODES: Readonly<Record<string, string>> = Object.freeze({\n  mainnet: 'https://api.avax.network',\n  fuji: 'https://api.avax-test.network',\n});\n\nconst DATA_API = 'https://data-api.avax.network/v1/networks';\n\nconst CHAINS: Readonly<\n  Record<string, { readonly alias: string; readonly name: string }>\n> = Object.freeze({\n  'avalanche-x': { alias: 'X', name: 'x-chain' },\n  'avalanche-p': { alias: 'P', name: 'p-chain' },\n});\n\n/** Own keys only: `constructor`, `toString` or `__proto__` is not a chain or network. */\nconst supports = (chain: string, network: string): boolean =>\n  Object.hasOwn(CHAINS, chain) && Object.hasOwn(NODES, network);\n\n/** Unreachable through the catalog, which asks `supports` first. */\nfunction chainOf(input: PresetInput) {\n  if (!supports(input.chain, input.network)) {\n    throw new Error(`no Avalanche endpoint for ${input.chain}:${input.network}`);\n  }\n  return CHAINS[input.chain] as { readonly alias: string; readonly name: string };\n}\n\nconst nodeUrl = (input: PresetInput): string =>\n  `${NODES[input.network] as string}/ext/bc/${chainOf(input).alias}`;\n\nconst dataApiUrl = (input: PresetInput): string =>\n  `${DATA_API}/${input.network}/blockchains/${chainOf(input).name}`;\n\n/** The revealed key; the error names the preset and network, never the key. */\nfunction apiKeyOf(input: PresetInput): string {\n  const key: unknown = input.apiKey === undefined ? undefined : reveal(input.apiKey);\n  if (typeof key !== 'string' || key.trim() === '') {\n    throw new ConfigError(\n      'CONFIG_INVALID',\n      `provider preset 'glacier' requires a non-empty apiKey for ${input.chain}:${input.network}`,\n    );\n  }\n  return key;\n}\n\n/**\n * Built once at module level, so the plugin's functions keep their identity: registration\n * compares functions by identity, and rebuilt ones would make the same plugin a new one.\n */\nexport const AVALANCHE_PRESETS: readonly ProviderPreset[] = deepFreeze([\n  {\n    name: 'public',\n    kind: 'rpc',\n    production: false,\n    supports,\n    endpoints: (input: PresetInput): readonly EndpointConfig[] => [\n      { name: 'avax', url: nodeUrl(input) },\n    ],\n  },\n  {\n    name: 'public',\n    kind: 'indexer',\n    production: false,\n    supports,\n    endpoints: (input: PresetInput): readonly EndpointConfig[] => [\n      { name: 'data-api', url: dataApiUrl(input) },\n    ],\n  },\n  {\n    name: 'glacier',\n    kind: 'indexer',\n    requiresApiKey: true,\n    supports,\n    endpoints: (input: PresetInput): readonly EndpointConfig[] => [\n      {\n        name: 'data-api',\n        url: dataApiUrl(input),\n        headers: { 'x-glacier-api-key': secret(apiKeyOf(input)) },\n      },\n    ],\n  },\n] satisfies ProviderPreset[]);\n"]}

package/dist/adapters/avalanche/proofs.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Proofs (the finalized-state checks behind `proven` verdicts) and the block source.
+ *
+ * Snowman never reverts an accepted block, so with the default policy (1 confirmation) an
+ * accepted transaction is final. Every fact is read under the proof quorum (one
+ * endpoint's word never decides), each at its own height with a monotone key, and no
+ * endpoint proposes the height: "block h is final" is "every proof endpoint holds a block
+ * at h + N − 1".
+ *
+ * - `includedFinal` answers "included" only when the proof endpoints agree the transaction
+ *   is accepted and the block at its located height is the located block and holds it. It
+ *   answers "not included" only when one of its inputs is gone from the sender's outputs on
+ *   every proof endpoint and, read after that, the transaction is still not accepted: then
+ *   another transaction spent the input, and ours can never be accepted. Every other case
+ *   decides nothing (a retryable `ProviderError`).
+ * - `slotConsumed` reads the sender's outputs: an input missing from them is spent.
+ * - The block source reads blocks by height; their transactions are read by id from the
+ *   node, as bytes that hash to that id. A P-Chain proposal transaction counts as failed
+ *   when its proposal was aborted.
+ */
+import type { BlockSource, ProofSource } from '../../core/driver/types';
+import { type NodeBlock } from './api';
+import { type AvalancheContext } from './context';
+/** Blocks `finalizedHead` trails one endpoint's head by, so peers can attest it. */
+export declare const PEER_SKEW = 1n;
+/** Splits an `inputs` ordering entry (`txID:outputIndex`); malformed data decides nothing. */
+export declare function parseInput(input: string): {
+    txId: string;
+    outputIndex: number;
+};
+/**
+ * The reads a proof attests under the proof quorum, each fact at its own height, which no
+ * endpoint proposes.
+ */
+export declare function attestedReads(ctx: AvalancheContext): {
+    holds: (height: bigint) => Promise<boolean>;
+    blockAt: (height: bigint) => Promise<NodeBlock | null>;
+    final: (height: bigint) => Promise<boolean>;
+};
+export declare function proofSource(ctx: AvalancheContext): ProofSource;
+export declare function blockSource(ctx: AvalancheContext): BlockSource;