crypto-aio 0.0.3 → 0.1.0

package/dist/adapters/avalanche/api.js

@@ -0,0 +1,381 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DataApi = exports.AvalancheNode = exports.UTXO_PAGE = exports.malformed = void 0;
+exports.isNodeNotFound = isNodeNotFound;
+exports.isHttpNotFound = isHttpNotFound;
+exports.parseHeight = parseHeight;
+exports.decodeChecked = decodeChecked;
+exports.encodeChecked = encodeChecked;
+exports.parseBlock = parseBlock;
+exports.parsePlatformStatus = parsePlatformStatus;
+/**
+ * The two data sources of the Avalanche driver, read through the core's policy-wrapped
+ * transports, and strict parsers for their answers: nothing an endpoint sends is trusted
+ * for its shape, and a malformed answer is a retryable `PROVIDER_UNAVAILABLE`.
+ * - `AvalancheNode`: an AvalancheGo node's chain API (`avm.*` on the X-Chain, `platform.*`
+ *   on the P-Chain), JSON-RPC at the endpoint's URL (`…/ext/bc/X`). Bytes come hex encoded
+ *   with a 4-byte SHA-256 checksum, which is checked; transaction bytes must also hash to
+ *   the id asked for, so they authenticate themselves.
+ * - `DataApi`: the Avalanche Data API (the indexer). It only locates a transaction's block
+ *   and lists an address's transactions; the node proves what it locates.
+ * Texts never echo an endpoint's message, which can carry addresses or amounts: the
+ * transport keeps that in `details`.
+ */
+const sha256_1 = require("@noble/hashes/sha256");
+const error_1 = require("../../core/errors/error");
+const bytes_1 = require("../../core/util/bytes");
+const cb58_1 = require("./cb58");
+const malformed = (what) => new error_1.ProviderError('PROVIDER_UNAVAILABLE', `malformed Avalanche answer: ${what}`);
+exports.malformed = malformed;
+/** A definitive JSON-RPC "not found" (`not found`, `couldn't get tx: not found`, …). */
+function isNodeNotFound(error) {
+    if (!(0, error_1.isCryptoAioError)(error, 'RPC_ERROR') || error.ambiguous)
+        return false;
+    const message = error.details?.rpcMessage;
+    return typeof message === 'string' && /(?:^|: )not found$/.test(message);
+}
+/** A definitive HTTP 404 from the Data API. */
+function isHttpNotFound(error) {
+    return ((0, error_1.isCryptoAioError)(error, 'RPC_ERROR') &&
+        !error.ambiguous &&
+        error.details?.status === 404);
+}
+const record = (value, what) => {
+    if (value === null || typeof value !== 'object' || Array.isArray(value)) {
+        throw (0, exports.malformed)(what);
+    }
+    return value;
+};
+const MAX_HEIGHT = BigInt(Number.MAX_SAFE_INTEGER);
+/** A non-negative integer height, as a number, a bigint or a decimal string. */
+function parseHeight(value, what = 'height') {
+    let height;
+    if (typeof value === 'number' && Number.isSafeInteger(value))
+        height = BigInt(value);
+    else if (typeof value === 'bigint')
+        height = value;
+    else if (typeof value === 'string' && /^(0|[1-9][0-9]{0,15})$/.test(value))
+        height = BigInt(value);
+    else
+        throw (0, exports.malformed)(what);
+    if (height < 0n || height > MAX_HEIGHT)
+        throw (0, exports.malformed)(what);
+    return height;
+}
+/**
+ * A non-negative integer amount as a decimal string or an exact integer: node calls set
+ * `exactIntegers`, so a JSON number above 2^53 arrives as a `bigint`, never rounded.
+ */
+function parseAmount(value, what) {
+    if (typeof value === 'bigint' && value >= 0n)
+        return value;
+    if (typeof value === 'number' && Number.isSafeInteger(value) && value >= 0)
+        return BigInt(value);
+    if (typeof value === 'string' && /^(0|[1-9][0-9]{0,29})$/.test(value))
+        return BigInt(value);
+    throw (0, exports.malformed)(what);
+}
+const id = (value, what) => {
+    if (!(0, cb58_1.isId)(value))
+        throw (0, exports.malformed)(what);
+    return value;
+};
+/** `0x…` hex with a trailing 4-byte SHA-256 checksum, as AvalancheGo encodes bytes. */
+function decodeChecked(value, what) {
+    if (typeof value !== 'string' ||
+        !/^0x(?:[0-9a-fA-F]{2}){5,}$/.test(value) ||
+        value.length > 2 * 1024 * 1024) {
+        throw (0, exports.malformed)(what);
+    }
+    const raw = (0, bytes_1.fromHex)(value.slice(2));
+    const body = raw.subarray(0, -4);
+    if (!(0, bytes_1.equalBytes)((0, sha256_1.sha256)(body).subarray(-4), raw.subarray(-4)))
+        throw (0, exports.malformed)(what);
+    return Uint8Array.from(body);
+}
+/** `0x…` hex of `bytes` with AvalancheGo's checksum. */
+function encodeChecked(bytes) {
+    const out = new Uint8Array(bytes.length + 4);
+    out.set(bytes, 0);
+    out.set((0, sha256_1.sha256)(bytes).subarray(-4), bytes.length);
+    return (0, bytes_1.toHex)(out, true);
+}
+/** The JSON block of `getBlock`/`getBlockByHeight`, X-Chain or P-Chain, any block type. */
+function parseBlock(answer) {
+    const block = record(record(answer, 'block answer').block, 'block');
+    const txIds = [];
+    const txs = block.txs;
+    if (txs !== undefined && txs !== null) {
+        if (!Array.isArray(txs) || txs.length > 100_000)
+            throw (0, exports.malformed)('block.txs');
+        for (const tx of txs)
+            txIds.push(id(record(tx, 'block.txs').id, 'block.txs.id'));
+    }
+    // A P-Chain proposal block carries one proposal transaction besides its decision ones.
+    if (block.tx !== undefined && block.tx !== null) {
+        txIds.push(id(record(block.tx, 'block.tx').id, 'block.tx.id'));
+    }
+    if (new Set(txIds).size !== txIds.length)
+        throw (0, exports.malformed)('block transactions');
+    const time = block.time;
+    if (time !== undefined &&
+        (typeof time !== 'number' || !Number.isSafeInteger(time) || time < 0)) {
+        throw (0, exports.malformed)('block.time');
+    }
+    return {
+        id: id(block.id, 'block.id'),
+        parentId: id(block.parentID, 'block.parentID'),
+        height: parseHeight(block.height, 'block.height'),
+        ...(time !== undefined ? { timestamp: time } : {}),
+        txIds,
+    };
+}
+const PLATFORM_STATUSES = [
+    'Committed',
+    'Aborted',
+    'Processing',
+    'Dropped',
+    'Unknown',
+];
+function parsePlatformStatus(answer) {
+    const status = record(answer, 'tx status').status;
+    if (!PLATFORM_STATUSES.includes(status))
+        throw (0, exports.malformed)('tx status');
+    return status;
+}
+/** `getUTXOs` asks for at most this many outputs per page (AvalancheGo's maximum). */
+exports.UTXO_PAGE = 1024;
+/** No address is read past this many pages (about 100,000 outputs): bounded work. */
+const MAX_UTXO_PAGES = 100;
+class AvalancheNode {
+    #transport;
+    #prefix;
+    constructor(transport, vm) {
+        this.#transport = transport;
+        this.#prefix = vm === 'avm' ? 'avm' : 'platform';
+    }
+    #call(method, params, tags) {
+        return this.#transport.rpc(`${this.#prefix}.${method}`, params, {
+            exactIntegers: true,
+            ...tags,
+        });
+    }
+    async height(tags) {
+        const answer = await this.#call('getHeight', {}, tags);
+        return parseHeight(record(answer, 'getHeight').height);
+    }
+    /** The accepted block at `height`; `null` when the node has none there (yet). */
+    async blockAt(height, tags) {
+        try {
+            const answer = await this.#call('getBlockByHeight', { height: height.toString(), encoding: 'json' }, tags);
+            const block = parseBlock(answer);
+            if (block.height !== height)
+                throw (0, exports.malformed)('the block is at another height');
+            return block;
+        }
+        catch (error) {
+            if (isNodeNotFound(error))
+                return null;
+            throw error;
+        }
+    }
+    async blockById(blockId, tags) {
+        try {
+            const block = parseBlock(await this.#call('getBlock', { blockID: blockId, encoding: 'json' }, tags));
+            if (block.id !== blockId)
+                throw (0, exports.malformed)('the block has another id');
+            return block;
+        }
+        catch (error) {
+            if (isNodeNotFound(error))
+                return null;
+            throw error;
+        }
+    }
+    /**
+     * An accepted transaction's signed bytes, which must hash to `txId`; `null` when the node
+     * does not have it in its accepted state.
+     */
+    async txBytes(txId, tags) {
+        let answer;
+        try {
+            answer = await this.#call('getTx', { txID: txId, encoding: 'hex' }, tags);
+        }
+        catch (error) {
+            if (isNodeNotFound(error))
+                return null;
+            throw error;
+        }
+        const bytes = decodeChecked(record(answer, 'getTx').tx, 'getTx.tx');
+        if ((0, cb58_1.idOf)(bytes) !== txId)
+            throw (0, exports.malformed)('transaction bytes of another id');
+        return bytes;
+    }
+    /** P-Chain only: committed, aborted, in a mempool, dropped by one, or unknown. */
+    async txStatus(txId, tags) {
+        return parsePlatformStatus(await this.#call('getTxStatus', { txID: txId }, tags));
+    }
+    /**
+     * Every output the node lists for `address` (its UTXO set), as raw UTXO bytes, read page
+     * by page. An output listed twice alike is kept once; listed twice differently, the
+     * answer is malformed.
+     */
+    async utxos(address, tags) {
+        const seen = new Map();
+        const out = [];
+        let start;
+        for (let page = 0;; page++) {
+            if (page >= MAX_UTXO_PAGES)
+                throw (0, exports.malformed)('more unspent outputs than are read');
+            const answer = record(await this.#call('getUTXOs', {
+                addresses: [address],
+                limit: exports.UTXO_PAGE,
+                encoding: 'hex',
+                ...(start ? { startIndex: start } : {}),
+            }, tags), 'getUTXOs');
+            const utxos = answer.utxos;
+            if (!Array.isArray(utxos) || utxos.length > exports.UTXO_PAGE)
+                throw (0, exports.malformed)('utxos');
+            const fetched = parseAmount(answer.numFetched, 'numFetched');
+            if (fetched !== BigInt(utxos.length))
+                throw (0, exports.malformed)('numFetched');
+            for (const text of utxos) {
+                const bytes = decodeChecked(text, 'utxo');
+                const key = (0, bytes_1.toHex)((0, sha256_1.sha256)(bytes));
+                const head = (0, bytes_1.toHex)(bytes.subarray(0, 38)); // codec, txID, output index
+                const known = seen.get(head);
+                if (known === undefined) {
+                    seen.set(head, key);
+                    out.push(bytes);
+                }
+                else if (known !== key) {
+                    throw (0, exports.malformed)('an unspent output listed twice, differently');
+                }
+            }
+            if (utxos.length < exports.UTXO_PAGE)
+                return out;
+            const end = record(answer.endIndex, 'endIndex');
+            if (typeof end.address !== 'string' || typeof end.utxo !== 'string') {
+                throw (0, exports.malformed)('endIndex');
+            }
+            start = { address: end.address, utxo: end.utxo };
+        }
+    }
+    /** Issues signed bytes; resolves to the id the node gives them. */
+    async issueTx(bytes, tags) {
+        const answer = await this.#call('issueTx', { tx: encodeChecked(bytes), encoding: 'hex' }, tags);
+        return id(record(answer, 'issueTx').txID, 'issueTx.txID');
+    }
+    /** X-Chain: the fixed fee of a transaction (`txFee`), in nAVAX. */
+    async txFee(tags) {
+        return parseAmount(record(await this.#call('getTxFee', {}, tags), 'getTxFee').txFee, 'txFee');
+    }
+    /** P-Chain: the current gas price and capacity (Etna's dynamic fees). */
+    async feeState(tags) {
+        const state = record(await this.#call('getFeeState', {}, tags), 'getFeeState');
+        if (typeof state.timestamp !== 'string' || state.timestamp.length > 64) {
+            throw (0, exports.malformed)('feeState.timestamp');
+        }
+        return {
+            capacity: parseAmount(state.capacity, 'feeState.capacity'),
+            excess: parseAmount(state.excess, 'feeState.excess'),
+            price: parseAmount(state.price, 'feeState.price'),
+            timestamp: state.timestamp,
+        };
+    }
+    /** P-Chain: the weights of the four fee dimensions and the minimum gas price. */
+    async feeConfig(tags) {
+        const config = record(await this.#call('getFeeConfig', {}, tags), 'getFeeConfig');
+        const weights = config.weights;
+        if (!Array.isArray(weights) ||
+            weights.length !== 4 ||
+            !weights.every((w) => Number.isSafeInteger(w) && w >= 0)) {
+            throw (0, exports.malformed)('feeConfig.weights');
+        }
+        return {
+            weights: weights,
+            minPrice: parseAmount(config.minPrice, 'feeConfig.minPrice'),
+        };
+    }
+}
+exports.AvalancheNode = AvalancheNode;
+const PAGE_TOKEN = /^[A-Za-z0-9_-]{1,256}$/;
+/** A Data API transaction's block, or `undefined` when it has none (non-linear X-Chain). */
+function locationOf(tx) {
+    const height = tx.blockHeight ?? tx.blockNumber;
+    if (height === undefined && tx.blockHash === undefined)
+        return undefined;
+    return {
+        height: parseHeight(height, 'transaction block height'),
+        hash: id(tx.blockHash, 'transaction block hash'),
+    };
+}
+class DataApi {
+    #transport;
+    constructor(transport) {
+        this.#transport = transport;
+    }
+    /** Where the indexer says `txId` is; `null` when it does not know it (404). */
+    async locate(txId, tags) {
+        let answer;
+        try {
+            answer = await this.#transport.http({ method: 'GET', path: `/transactions/${txId}`, route: '/transactions/:id' }, tags);
+        }
+        catch (error) {
+            if (isHttpNotFound(error))
+                return null;
+            throw error;
+        }
+        const tx = record(answer, 'transaction');
+        if (tx.txHash !== txId)
+            throw (0, exports.malformed)('a transaction of another id');
+        return locationOf(tx) ?? 'no-block';
+    }
+    /** A page of `address`'s transactions, newest first. */
+    async history(address, options, tags) {
+        const answer = record(await this.#transport.http({
+            method: 'GET',
+            path: '/transactions',
+            route: '/transactions',
+            query: {
+                addresses: address,
+                pageSize: String(options.pageSize),
+                sortOrder: 'desc',
+                ...(options.cursor !== undefined ? { pageToken: options.cursor } : {}),
+            },
+        }, tags), 'transactions');
+        const txs = answer.transactions;
+        if (!Array.isArray(txs) || txs.length > options.pageSize) {
+            throw (0, exports.malformed)('transactions');
+        }
+        const items = txs.map((entry) => {
+            const tx = record(entry, 'transaction');
+            const location = locationOf(tx);
+            return { txId: id(tx.txHash, 'txHash'), ...(location ? { location } : {}) };
+        });
+        const next = answer.nextPageToken;
+        if (next !== undefined && next !== null && next !== '') {
+            if (typeof next !== 'string' || !PAGE_TOKEN.test(next)) {
+                throw (0, exports.malformed)('nextPageToken');
+            }
+            return { items, next };
+        }
+        return { items };
+    }
+    /** The hash of the indexer's block at height 0 (its identity probe). */
+    static blockZero(answer) {
+        const block = record(answer, 'block');
+        if (parseHeight(block.blockNumber, 'blockNumber') !== 0n)
+            throw (0, exports.malformed)('block 0');
+        return id(block.blockHash, 'blockHash');
+    }
+    /** The indexer's newest block height (its height probe). */
+    static latestHeight(answer) {
+        const blocks = record(answer, 'blocks').blocks;
+        if (!Array.isArray(blocks) || blocks.length !== 1)
+            throw (0, exports.malformed)('blocks');
+        return parseHeight(record(blocks[0], 'block').blockNumber, 'blockNumber');
+    }
+}
+exports.DataApi = DataApi;
+//# sourceMappingURL=api.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../../src/adapters/avalanche/api.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The two data sources of the Avalanche driver, read through the core's policy-wrapped\n * transports, and strict parsers for their answers: nothing an endpoint sends is trusted\n * for its shape, and a malformed answer is a retryable `PROVIDER_UNAVAILABLE`.\n * - `AvalancheNode`: an AvalancheGo node's chain API (`avm.*` on the X-Chain, `platform.*`\n *   on the P-Chain), JSON-RPC at the endpoint's URL (`…/ext/bc/X`). Bytes come hex encoded\n *   with a 4-byte SHA-256 checksum, which is checked; transaction bytes must also hash to\n *   the id asked for, so they authenticate themselves.\n * - `DataApi`: the Avalanche Data API (the indexer). It only locates a transaction's block\n *   and lists an address's transactions; the node proves what it locates.\n * Texts never echo an endpoint's message, which can carry addresses or amounts: the\n * transport keeps that in `details`.\n */\nimport { sha256 } from '@noble/hashes/sha256';\nimport { ProviderError, isCryptoAioError } from '../../core/errors/error';\nimport { equalBytes, fromHex, toHex } from '../../core/util/bytes';\nimport type { Transport } from '../../core/transport/types';\nimport { idOf, isId } from './cb58';\nimport type { AvalancheCallTags, AvalancheVm } from './types';\n\n/** A block as the node reports it; ids are CB58. */\nexport interface NodeBlock {\n  readonly id: string;\n  readonly parentId: string;\n  readonly height: bigint;\n  /** Unix seconds; absent on P-Chain blocks from before the Banff upgrade. */\n  readonly timestamp?: number;\n  /** Every transaction the block carries, decision and proposal alike. */\n  readonly txIds: readonly string[];\n}\n\n/** The P-Chain's view of a transaction (`platform.getTxStatus`). */\nexport type PlatformStatus =\n  'Committed' | 'Aborted' | 'Processing' | 'Dropped' | 'Unknown';\n\nexport interface FeeState {\n  readonly capacity: bigint;\n  readonly excess: bigint;\n  readonly price: bigint;\n  readonly timestamp: string;\n}\n\n/** The P-Chain's fee dimensions' weights: bandwidth, reads, writes, compute. */\nexport type FeeWeights = readonly [number, number, number, number];\n\n/** Where the indexer says a transaction is. */\nexport interface Location {\n  readonly height: bigint;\n  readonly hash: string;\n}\n\nexport const malformed = (what: string): ProviderError =>\n  new ProviderError('PROVIDER_UNAVAILABLE', `malformed Avalanche answer: ${what}`);\n\n/** A definitive JSON-RPC \"not found\" (`not found`, `couldn't get tx: not found`, …). */\nexport function isNodeNotFound(error: unknown): boolean {\n  if (!isCryptoAioError(error, 'RPC_ERROR') || error.ambiguous) return false;\n  const message = error.details?.rpcMessage;\n  return typeof message === 'string' && /(?:^|: )not found$/.test(message);\n}\n\n/** A definitive HTTP 404 from the Data API. */\nexport function isHttpNotFound(error: unknown): boolean {\n  return (\n    isCryptoAioError(error, 'RPC_ERROR') &&\n    !error.ambiguous &&\n    error.details?.status === 404\n  );\n}\n\ntype Json = Readonly<Record<string, unknown>>;\n\nconst record = (value: unknown, what: string): Json => {\n  if (value === null || typeof value !== 'object' || Array.isArray(value)) {\n    throw malformed(what);\n  }\n  return value as Json;\n};\n\nconst MAX_HEIGHT = BigInt(Number.MAX_SAFE_INTEGER);\n\n/** A non-negative integer height, as a number, a bigint or a decimal string. */\nexport function parseHeight(value: unknown, what = 'height'): bigint {\n  let height: bigint;\n  if (typeof value === 'number' && Number.isSafeInteger(value)) height = BigInt(value);\n  else if (typeof value === 'bigint') height = value;\n  else if (typeof value === 'string' && /^(0|[1-9][0-9]{0,15})$/.test(value))\n    height = BigInt(value);\n  else throw malformed(what);\n  if (height < 0n || height > MAX_HEIGHT) throw malformed(what);\n  return height;\n}\n\n/**\n * A non-negative integer amount as a decimal string or an exact integer: node calls set\n * `exactIntegers`, so a JSON number above 2^53 arrives as a `bigint`, never rounded.\n */\nfunction parseAmount(value: unknown, what: string): bigint {\n  if (typeof value === 'bigint' && value >= 0n) return value;\n  if (typeof value === 'number' && Number.isSafeInteger(value) && value >= 0)\n    return BigInt(value);\n  if (typeof value === 'string' && /^(0|[1-9][0-9]{0,29})$/.test(value))\n    return BigInt(value);\n  throw malformed(what);\n}\n\nconst id = (value: unknown, what: string): string => {\n  if (!isId(value)) throw malformed(what);\n  return value;\n};\n\n/** `0x…` hex with a trailing 4-byte SHA-256 checksum, as AvalancheGo encodes bytes. */\nexport function decodeChecked(value: unknown, what: string): Uint8Array {\n  if (\n    typeof value !== 'string' ||\n    !/^0x(?:[0-9a-fA-F]{2}){5,}$/.test(value) ||\n    value.length > 2 * 1024 * 1024\n  ) {\n    throw malformed(what);\n  }\n  const raw = fromHex(value.slice(2));\n  const body = raw.subarray(0, -4);\n  if (!equalBytes(sha256(body).subarray(-4), raw.subarray(-4))) throw malformed(what);\n  return Uint8Array.from(body);\n}\n\n/** `0x…` hex of `bytes` with AvalancheGo's checksum. */\nexport function encodeChecked(bytes: Uint8Array): string {\n  const out = new Uint8Array(bytes.length + 4);\n  out.set(bytes, 0);\n  out.set(sha256(bytes).subarray(-4), bytes.length);\n  return toHex(out, true);\n}\n\n/** The JSON block of `getBlock`/`getBlockByHeight`, X-Chain or P-Chain, any block type. */\nexport function parseBlock(answer: unknown): NodeBlock {\n  const block = record(record(answer, 'block answer').block, 'block');\n  const txIds: string[] = [];\n  const txs = block.txs;\n  if (txs !== undefined && txs !== null) {\n    if (!Array.isArray(txs) || txs.length > 100_000) throw malformed('block.txs');\n    for (const tx of txs) txIds.push(id(record(tx, 'block.txs').id, 'block.txs.id'));\n  }\n  // A P-Chain proposal block carries one proposal transaction besides its decision ones.\n  if (block.tx !== undefined && block.tx !== null) {\n    txIds.push(id(record(block.tx, 'block.tx').id, 'block.tx.id'));\n  }\n  if (new Set(txIds).size !== txIds.length) throw malformed('block transactions');\n  const time = block.time;\n  if (\n    time !== undefined &&\n    (typeof time !== 'number' || !Number.isSafeInteger(time) || time < 0)\n  ) {\n    throw malformed('block.time');\n  }\n  return {\n    id: id(block.id, 'block.id'),\n    parentId: id(block.parentID, 'block.parentID'),\n    height: parseHeight(block.height, 'block.height'),\n    ...(time !== undefined ? { timestamp: time } : {}),\n    txIds,\n  };\n}\n\nconst PLATFORM_STATUSES: readonly PlatformStatus[] = [\n  'Committed',\n  'Aborted',\n  'Processing',\n  'Dropped',\n  'Unknown',\n];\n\nexport function parsePlatformStatus(answer: unknown): PlatformStatus {\n  const status = record(answer, 'tx status').status;\n  if (!PLATFORM_STATUSES.includes(status as PlatformStatus)) throw malformed('tx status');\n  return status as PlatformStatus;\n}\n\n/** `getUTXOs` asks for at most this many outputs per page (AvalancheGo's maximum). */\nexport const UTXO_PAGE = 1024;\n/** No address is read past this many pages (about 100,000 outputs): bounded work. */\nconst MAX_UTXO_PAGES = 100;\n\nexport class AvalancheNode {\n  readonly #transport: Transport;\n  readonly #prefix: 'avm' | 'platform';\n\n  constructor(transport: Transport, vm: AvalancheVm) {\n    this.#transport = transport;\n    this.#prefix = vm === 'avm' ? 'avm' : 'platform';\n  }\n\n  #call<T = unknown>(method: string, params: unknown, tags: AvalancheCallTags) {\n    return this.#transport.rpc<T>(`${this.#prefix}.${method}`, params, {\n      exactIntegers: true,\n      ...tags,\n    });\n  }\n\n  async height(tags: AvalancheCallTags): Promise<bigint> {\n    const answer = await this.#call('getHeight', {}, tags);\n    return parseHeight(record(answer, 'getHeight').height);\n  }\n\n  /** The accepted block at `height`; `null` when the node has none there (yet). */\n  async blockAt(height: bigint, tags: AvalancheCallTags): Promise<NodeBlock | null> {\n    try {\n      const answer = await this.#call(\n        'getBlockByHeight',\n        { height: height.toString(), encoding: 'json' },\n        tags,\n      );\n      const block = parseBlock(answer);\n      if (block.height !== height) throw malformed('the block is at another height');\n      return block;\n    } catch (error) {\n      if (isNodeNotFound(error)) return null;\n      throw error;\n    }\n  }\n\n  async blockById(blockId: string, tags: AvalancheCallTags): Promise<NodeBlock | null> {\n    try {\n      const block = parseBlock(\n        await this.#call('getBlock', { blockID: blockId, encoding: 'json' }, tags),\n      );\n      if (block.id !== blockId) throw malformed('the block has another id');\n      return block;\n    } catch (error) {\n      if (isNodeNotFound(error)) return null;\n      throw error;\n    }\n  }\n\n  /**\n   * An accepted transaction's signed bytes, which must hash to `txId`; `null` when the node\n   * does not have it in its accepted state.\n   */\n  async txBytes(txId: string, tags: AvalancheCallTags): Promise<Uint8Array | null> {\n    let answer: unknown;\n    try {\n      answer = await this.#call('getTx', { txID: txId, encoding: 'hex' }, tags);\n    } catch (error) {\n      if (isNodeNotFound(error)) return null;\n      throw error;\n    }\n    const bytes = decodeChecked(record(answer, 'getTx').tx, 'getTx.tx');\n    if (idOf(bytes) !== txId) throw malformed('transaction bytes of another id');\n    return bytes;\n  }\n\n  /** P-Chain only: committed, aborted, in a mempool, dropped by one, or unknown. */\n  async txStatus(txId: string, tags: AvalancheCallTags): Promise<PlatformStatus> {\n    return parsePlatformStatus(await this.#call('getTxStatus', { txID: txId }, tags));\n  }\n\n  /**\n   * Every output the node lists for `address` (its UTXO set), as raw UTXO bytes, read page\n   * by page. An output listed twice alike is kept once; listed twice differently, the\n   * answer is malformed.\n   */\n  async utxos(address: string, tags: AvalancheCallTags): Promise<Uint8Array[]> {\n    const seen = new Map<string, string>();\n    const out: Uint8Array[] = [];\n    let start: Json | undefined;\n    for (let page = 0; ; page++) {\n      if (page >= MAX_UTXO_PAGES) throw malformed('more unspent outputs than are read');\n      const answer = record(\n        await this.#call(\n          'getUTXOs',\n          {\n            addresses: [address],\n            limit: UTXO_PAGE,\n            encoding: 'hex',\n            ...(start ? { startIndex: start } : {}),\n          },\n          tags,\n        ),\n        'getUTXOs',\n      );\n      const utxos = answer.utxos;\n      if (!Array.isArray(utxos) || utxos.length > UTXO_PAGE) throw malformed('utxos');\n      const fetched = parseAmount(answer.numFetched, 'numFetched');\n      if (fetched !== BigInt(utxos.length)) throw malformed('numFetched');\n      for (const text of utxos) {\n        const bytes = decodeChecked(text, 'utxo');\n        const key = toHex(sha256(bytes));\n        const head = toHex(bytes.subarray(0, 38)); // codec, txID, output index\n        const known = seen.get(head);\n        if (known === undefined) {\n          seen.set(head, key);\n          out.push(bytes);\n        } else if (known !== key) {\n          throw malformed('an unspent output listed twice, differently');\n        }\n      }\n      if (utxos.length < UTXO_PAGE) return out;\n      const end = record(answer.endIndex, 'endIndex');\n      if (typeof end.address !== 'string' || typeof end.utxo !== 'string') {\n        throw malformed('endIndex');\n      }\n      start = { address: end.address, utxo: end.utxo };\n    }\n  }\n\n  /** Issues signed bytes; resolves to the id the node gives them. */\n  async issueTx(bytes: Uint8Array, tags: AvalancheCallTags): Promise<string> {\n    const answer = await this.#call(\n      'issueTx',\n      { tx: encodeChecked(bytes), encoding: 'hex' },\n      tags,\n    );\n    return id(record(answer, 'issueTx').txID, 'issueTx.txID');\n  }\n\n  /** X-Chain: the fixed fee of a transaction (`txFee`), in nAVAX. */\n  async txFee(tags: AvalancheCallTags): Promise<bigint> {\n    return parseAmount(\n      record(await this.#call('getTxFee', {}, tags), 'getTxFee').txFee,\n      'txFee',\n    );\n  }\n\n  /** P-Chain: the current gas price and capacity (Etna's dynamic fees). */\n  async feeState(tags: AvalancheCallTags): Promise<FeeState> {\n    const state = record(await this.#call('getFeeState', {}, tags), 'getFeeState');\n    if (typeof state.timestamp !== 'string' || state.timestamp.length > 64) {\n      throw malformed('feeState.timestamp');\n    }\n    return {\n      capacity: parseAmount(state.capacity, 'feeState.capacity'),\n      excess: parseAmount(state.excess, 'feeState.excess'),\n      price: parseAmount(state.price, 'feeState.price'),\n      timestamp: state.timestamp,\n    };\n  }\n\n  /** P-Chain: the weights of the four fee dimensions and the minimum gas price. */\n  async feeConfig(\n    tags: AvalancheCallTags,\n  ): Promise<{ readonly weights: FeeWeights; readonly minPrice: bigint }> {\n    const config = record(await this.#call('getFeeConfig', {}, tags), 'getFeeConfig');\n    const weights = config.weights;\n    if (\n      !Array.isArray(weights) ||\n      weights.length !== 4 ||\n      !weights.every((w) => Number.isSafeInteger(w) && (w as number) >= 0)\n    ) {\n      throw malformed('feeConfig.weights');\n    }\n    return {\n      weights: weights as unknown as FeeWeights,\n      minPrice: parseAmount(config.minPrice, 'feeConfig.minPrice'),\n    };\n  }\n}\n\n/** One transaction of an address's history, as the Data API lists it (newest first). */\nexport interface HistoryEntry {\n  readonly txId: string;\n  /** Absent for an X-Chain transaction from before its linearization (no block). */\n  readonly location?: Location;\n}\n\nconst PAGE_TOKEN = /^[A-Za-z0-9_-]{1,256}$/;\n\n/** A Data API transaction's block, or `undefined` when it has none (non-linear X-Chain). */\nfunction locationOf(tx: Json): Location | undefined {\n  const height = tx.blockHeight ?? tx.blockNumber;\n  if (height === undefined && tx.blockHash === undefined) return undefined;\n  return {\n    height: parseHeight(height, 'transaction block height'),\n    hash: id(tx.blockHash, 'transaction block hash'),\n  };\n}\n\nexport class DataApi {\n  readonly #transport: Transport;\n\n  constructor(transport: Transport) {\n    this.#transport = transport;\n  }\n\n  /** Where the indexer says `txId` is; `null` when it does not know it (404). */\n  async locate(\n    txId: string,\n    tags: AvalancheCallTags,\n  ): Promise<Location | null | 'no-block'> {\n    let answer: unknown;\n    try {\n      answer = await this.#transport.http(\n        { method: 'GET', path: `/transactions/${txId}`, route: '/transactions/:id' },\n        tags,\n      );\n    } catch (error) {\n      if (isHttpNotFound(error)) return null;\n      throw error;\n    }\n    const tx = record(answer, 'transaction');\n    if (tx.txHash !== txId) throw malformed('a transaction of another id');\n    return locationOf(tx) ?? 'no-block';\n  }\n\n  /** A page of `address`'s transactions, newest first. */\n  async history(\n    address: string,\n    options: { readonly cursor?: string; readonly pageSize: number },\n    tags: AvalancheCallTags,\n  ): Promise<{ readonly items: readonly HistoryEntry[]; readonly next?: string }> {\n    const answer = record(\n      await this.#transport.http(\n        {\n          method: 'GET',\n          path: '/transactions',\n          route: '/transactions',\n          query: {\n            addresses: address,\n            pageSize: String(options.pageSize),\n            sortOrder: 'desc',\n            ...(options.cursor !== undefined ? { pageToken: options.cursor } : {}),\n          },\n        },\n        tags,\n      ),\n      'transactions',\n    );\n    const txs = answer.transactions;\n    if (!Array.isArray(txs) || txs.length > options.pageSize) {\n      throw malformed('transactions');\n    }\n    const items = txs.map((entry): HistoryEntry => {\n      const tx = record(entry, 'transaction');\n      const location = locationOf(tx);\n      return { txId: id(tx.txHash, 'txHash'), ...(location ? { location } : {}) };\n    });\n    const next = answer.nextPageToken;\n    if (next !== undefined && next !== null && next !== '') {\n      if (typeof next !== 'string' || !PAGE_TOKEN.test(next)) {\n        throw malformed('nextPageToken');\n      }\n      return { items, next };\n    }\n    return { items };\n  }\n\n  /** The hash of the indexer's block at height 0 (its identity probe). */\n  static blockZero(answer: unknown): string {\n    const block = record(answer, 'block');\n    if (parseHeight(block.blockNumber, 'blockNumber') !== 0n) throw malformed('block 0');\n    return id(block.blockHash, 'blockHash');\n  }\n\n  /** The indexer's newest block height (its height probe). */\n  static latestHeight(answer: unknown): bigint {\n    const blocks = record(answer, 'blocks').blocks;\n    if (!Array.isArray(blocks) || blocks.length !== 1) throw malformed('blocks');\n    return parseHeight(record(blocks[0], 'block').blockNumber, 'blockNumber');\n  }\n}\n"]}

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

@@ -0,0 +1,13 @@
+import type { Broadcaster, TxBuilder } from '../../core/driver/types';
+import type { RawTx, UnsignedTx } from '../../core/model/transaction';
+import type { SignatureBundle } from '../../core/signing/types';
+import type { AvalancheContext } from './context';
+/** At most this many outputs per transfer (and one more for change). */
+export declare const MAX_OUTPUTS = 127;
+/** At most this many inputs: well inside 64 KiB and the P-Chain's gas capacity. */
+export declare const MAX_INPUTS = 128;
+export interface AvalancheBuilder extends TxBuilder {
+    signaturesFrom(unsigned: UnsignedTx, signed: RawTx): readonly SignatureBundle[];
+}
+export declare function avalancheBuilder(ctx: AvalancheContext): AvalancheBuilder;
+export declare function avalancheBroadcaster(ctx: AvalancheContext): Broadcaster;