crypto-aio 0.0.2 → 0.1.0

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

@@ -0,0 +1,94 @@
+import type { AvalancheNetworkConfig } from './network';
+import { type SdkContext, type SdkFeeState, type SdkSignedTx, type SdkTransaction, type SdkUtxo } from './sdk';
+import type { FeeWeights } from './api';
+/** AvalancheGo's mempool refuses a transaction of more bytes (`MaxTxSize`, 64 KiB). */
+export declare const MAX_TX_BYTES: number;
+/** `avax.MaxMemoSize`. */
+export declare const MAX_MEMO_BYTES = 256;
+/** A reservation key: `txID:outputIndex`. */
+export declare const utxoKey: (txId: string, outputIndex: number) => string;
+/** The `utxoId` of raw UTXO bytes: codec (2), txID (32), output index (4) lead them all. */
+export declare function utxoKeyOf(bytes: Uint8Array): string;
+/** An unspent output, read from the node's bytes. */
+export interface ParsedUtxo {
+    readonly utxoId: string;
+    readonly txId: string;
+    readonly outputIndex: number;
+    readonly assetId: string;
+    readonly amount: bigint;
+    readonly locktime: bigint;
+    readonly threshold: number;
+    readonly owners: readonly Uint8Array[];
+    /** A `secp256k1fx.TransferOutput` (not stake-locked, minted or an NFT). */
+    readonly plain: boolean;
+    readonly sdk: SdkUtxo;
+}
+export declare function parseUtxo(bytes: Uint8Array, config: Pick<AvalancheNetworkConfig, 'vm'>): ParsedUtxo;
+/** Whether a transfer from `from` may spend `utxo`: plain AVAX, unlocked, `from` alone signs. */
+export declare function spendableBy(utxo: ParsedUtxo, from: Uint8Array, config: Pick<AvalancheNetworkConfig, 'avaxAssetId'>): boolean;
+/** Signed transaction bytes, parsed; their unsigned part re-encoded. */
+export interface ParsedTx {
+    readonly id: string;
+    readonly signed: SdkSignedTx;
+    readonly tx: SdkTransaction;
+    readonly unsignedBytes: Uint8Array;
+}
+export declare function parseSignedTx(bytes: Uint8Array, config: Pick<AvalancheNetworkConfig, 'vm'>): ParsedTx;
+/** The unsigned transaction in `bytes` (a prepared payload), re-encoded exactly. */
+export declare function parseUnsignedTx(bytes: Uint8Array, config: Pick<AvalancheNetworkConfig, 'vm'>): SdkTransaction;
+/** `r ‖ s ‖ v`: a 64-byte compact signature and its recovery id, as credentials hold them. */
+export declare function credentialSignature(compact: Uint8Array, recovery: number): Uint8Array;
+/** The signed bytes: every input's credential carries `signature` once per signer index. */
+export declare function assembleSigned(unsignedBytes: Uint8Array, signature: Uint8Array, config: Pick<AvalancheNetworkConfig, 'vm'>): Uint8Array;
+/** The addresses that signed `parsed`, once each, in credential order. */
+export declare function signersOf(parsed: ParsedTx): Uint8Array[];
+/** avalanchejs's `Context` for this network; `fees` fills the fee fields the builder reads. */
+export declare function sdkContext(config: AvalancheNetworkConfig, fees?: {
+    readonly txFee?: bigint;
+    readonly weights?: FeeWeights;
+}): SdkContext;
+export type FeePlan = {
+    readonly model: 'static';
+    readonly txFee: bigint;
+} | {
+    readonly model: 'dynamic';
+    readonly price: bigint;
+    readonly state: SdkFeeState;
+    readonly weights: FeeWeights;
+};
+export interface PlannedOutput {
+    readonly to: Uint8Array;
+    readonly amount: bigint;
+}
+export interface BuiltTx {
+    /** The unsigned bytes (codec version and transaction). */
+    readonly bytes: Uint8Array;
+    readonly inputs: readonly string[];
+    readonly fee: bigint;
+    /** P-Chain: the gas the transaction uses. */
+    readonly gas?: bigint;
+    readonly change: bigint;
+    readonly outputs: number;
+}
+/** The absurd-fee guard: no transfer ever pays more than `options.maxFee`. */
+export declare function assertSaneFee(fee: bigint, config: Pick<AvalancheNetworkConfig, 'maxFee'>): void;
+/**
+ * A BaseTx from `from` paying `outputs`, spending the first of `utxos` (in their order)
+ * that cover the outputs and the fee, with change back to `from`. Checked before it is
+ * returned.
+ */
+export declare function buildBaseTx(args: {
+    readonly config: AvalancheNetworkConfig;
+    readonly from: Uint8Array;
+    readonly utxos: readonly ParsedUtxo[];
+    readonly outputs: readonly PlannedOutput[];
+    readonly memo: Uint8Array;
+    readonly minIssuanceTime: bigint;
+    readonly fee: FeePlan;
+}): BuiltTx;
+/**
+ * An output that does not exist: `amount` of AVAX owned by `owner`, at a zero transaction
+ * id. Fee estimates build with it when the wallet's outputs do not cover a transfer, so the
+ * estimate still names the fee of a one-input transaction. Never spent.
+ */
+export declare function syntheticUtxo(owner: Uint8Array, amount: bigint, config: Pick<AvalancheNetworkConfig, 'vm' | 'avaxAssetId'>): ParsedUtxo;

package/dist/adapters/avalanche/codec.js

@@ -0,0 +1,371 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.utxoKey = exports.MAX_MEMO_BYTES = exports.MAX_TX_BYTES = void 0;
+exports.utxoKeyOf = utxoKeyOf;
+exports.parseUtxo = parseUtxo;
+exports.spendableBy = spendableBy;
+exports.parseSignedTx = parseSignedTx;
+exports.parseUnsignedTx = parseUnsignedTx;
+exports.credentialSignature = credentialSignature;
+exports.assembleSigned = assembleSigned;
+exports.signersOf = signersOf;
+exports.sdkContext = sdkContext;
+exports.assertSaneFee = assertSaneFee;
+exports.buildBaseTx = buildBaseTx;
+exports.syntheticUtxo = syntheticUtxo;
+/**
+ * Avalanche bytes through avalanchejs: unspent outputs, signed transactions, BaseTx
+ * building and credential assembly.
+ * - Every parse is a round trip: bytes that do not re-encode to themselves are not taken.
+ * - A transaction signs one digest, the SHA-256 of its unsigned bytes; every input's
+ *   credential carries the same 65-byte recoverable signature (r, s, recovery id).
+ * - A built transaction is checked before it is used (defence in depth against the SDK):
+ *   its network and chain, that it spends only the outputs offered, pays every intended
+ *   output exactly, sends the rest back to the sender, and burns exactly the expected fee.
+ * - A transaction's senders are the addresses its signatures recover to, for every input,
+ *   imported ones included.
+ */
+const secp256k1_1 = require("@noble/curves/secp256k1");
+const ripemd160_1 = require("@noble/hashes/ripemd160");
+const sha256_1 = require("@noble/hashes/sha256");
+const error_1 = require("../../core/errors/error");
+const bytes_1 = require("../../core/util/bytes");
+const api_1 = require("./api");
+const cb58_1 = require("./cb58");
+const sdk_1 = require("./sdk");
+/** AvalancheGo's mempool refuses a transaction of more bytes (`MaxTxSize`, 64 KiB). */
+exports.MAX_TX_BYTES = 64 * 1024;
+/** A secp256k1 credential of one signature: type id, count and the signature. */
+const CREDENTIAL_BYTES = 4 + 4 + 65;
+/** `avax.MaxMemoSize`. */
+exports.MAX_MEMO_BYTES = 256;
+const vmName = (config) => config.vm === 'avm' ? 'AVM' : 'PVM';
+/** A reservation key: `txID:outputIndex`. */
+const utxoKey = (txId, outputIndex) => `${txId}:${outputIndex}`;
+exports.utxoKey = utxoKey;
+/** The `utxoId` of raw UTXO bytes: codec (2), txID (32), output index (4) lead them all. */
+function utxoKeyOf(bytes) {
+    if (bytes.length < 38)
+        throw (0, api_1.malformed)('utxo');
+    const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    return (0, exports.utxoKey)((0, cb58_1.cb58Encode)(bytes.subarray(2, 34)), view.getUint32(34));
+}
+const hasAmount = (value) => typeof value.amount === 'function';
+function ownersOf(output) {
+    if (output._type === sdk_1.TYPES.transferOutput) {
+        return output.outputOwners;
+    }
+    if (output._type === sdk_1.TYPES.stakeableLockOut) {
+        const inner = output.transferOut;
+        return inner._type === sdk_1.TYPES.transferOutput
+            ? inner.outputOwners
+            : undefined;
+    }
+    return undefined;
+}
+function parseUtxo(bytes, config) {
+    const manager = sdk_1.avalanche.utils.getManagerForVM(vmName(config));
+    let utxo;
+    try {
+        utxo = manager.unpack(bytes, sdk_1.avalanche.Utxo);
+    }
+    catch {
+        throw (0, api_1.malformed)('utxo');
+    }
+    const reencoded = (() => {
+        try {
+            return new Uint8Array([0, 0, ...utxo.toBytes(manager.getDefaultCodec())]);
+        }
+        catch {
+            throw (0, api_1.malformed)('utxo');
+        }
+    })();
+    if (!(0, bytes_1.equalBytes)(reencoded, bytes))
+        throw (0, api_1.malformed)('utxo');
+    const owners = ownersOf(utxo.output);
+    const plain = utxo.output._type === sdk_1.TYPES.transferOutput;
+    const amount = hasAmount(utxo.output) ? utxo.output.amount() : 0n;
+    const locktime = utxo.output._type === sdk_1.TYPES.stakeableLockOut
+        ? utxo.output.getLocktime()
+        : (owners?.locktime.value() ?? 0n);
+    const txId = utxo.utxoId.txID.toString();
+    const outputIndex = utxo.utxoId.outputIdx.value();
+    return {
+        utxoId: (0, exports.utxoKey)(txId, outputIndex),
+        txId,
+        outputIndex,
+        assetId: utxo.assetId.toString(),
+        amount,
+        locktime,
+        threshold: owners?.threshold.value() ?? 0,
+        owners: owners?.addrs.map((a) => a.toBytes()) ?? [],
+        plain,
+        sdk: utxo,
+    };
+}
+/** Whether a transfer from `from` may spend `utxo`: plain AVAX, unlocked, `from` alone signs. */
+function spendableBy(utxo, from, config) {
+    return (utxo.plain &&
+        utxo.assetId === config.avaxAssetId &&
+        utxo.amount > 0n &&
+        utxo.locktime === 0n &&
+        utxo.threshold === 1 &&
+        utxo.owners.some((owner) => (0, bytes_1.equalBytes)(owner, from)));
+}
+function parseSignedTx(bytes, config) {
+    const manager = sdk_1.avalanche.utils.getManagerForVM(vmName(config));
+    let signed;
+    let reencoded;
+    let unsignedBytes;
+    try {
+        signed = manager.unpack(bytes, sdk_1.avalanche.avaxSerial.SignedTx);
+        reencoded = signed.toBytes();
+        unsignedBytes = manager.packCodec(signed.unsignedTx);
+    }
+    catch {
+        throw (0, api_1.malformed)('transaction');
+    }
+    if (!(0, bytes_1.equalBytes)(reencoded, bytes) ||
+        !(0, bytes_1.equalBytes)(bytes.subarray(0, unsignedBytes.length), unsignedBytes)) {
+        throw (0, api_1.malformed)('transaction');
+    }
+    return { id: (0, cb58_1.idOf)(bytes), signed, tx: signed.unsignedTx, unsignedBytes };
+}
+/** The unsigned transaction in `bytes` (a prepared payload), re-encoded exactly. */
+function parseUnsignedTx(bytes, config) {
+    const manager = sdk_1.avalanche.utils.getManagerForVM(vmName(config));
+    let tx;
+    try {
+        tx = manager.unpackTransaction(bytes);
+        if (!(0, bytes_1.equalBytes)(manager.packCodec(tx), bytes))
+            throw new Error('not exact');
+    }
+    catch {
+        throw new error_1.ValidationError('INVALID_INTENT', 'not an unsigned transaction of this chain');
+    }
+    return tx;
+}
+/** `r ‖ s ‖ v`: a 64-byte compact signature and its recovery id, as credentials hold them. */
+function credentialSignature(compact, recovery) {
+    const out = new Uint8Array(65);
+    out.set(compact, 0);
+    out[64] = recovery;
+    return out;
+}
+/** The signed bytes: every input's credential carries `signature` once per signer index. */
+function assembleSigned(unsignedBytes, signature, config) {
+    const tx = parseUnsignedTx(unsignedBytes, config);
+    const credentials = tx
+        .getSigIndices()
+        .map((indices) => new sdk_1.avalanche.Credential(indices.map(() => new sdk_1.avalanche.Signature(signature))));
+    return new sdk_1.avalanche.avaxSerial.SignedTx(tx, credentials).toBytes();
+}
+/** The 20-byte address a 65-byte signature over `digest` recovers to, if any. */
+function signerOf(signature, digest) {
+    if (signature.length !== 65 || signature[64] > 3)
+        return undefined;
+    try {
+        const publicKey = secp256k1_1.secp256k1.Signature.fromCompact(signature.subarray(0, 64))
+            .addRecoveryBit(signature[64])
+            .recoverPublicKey(digest)
+            .toRawBytes(true);
+        return (0, ripemd160_1.ripemd160)((0, sha256_1.sha256)(publicKey));
+    }
+    catch {
+        return undefined;
+    }
+}
+/** The addresses that signed `parsed`, once each, in credential order. */
+function signersOf(parsed) {
+    const digest = (0, sha256_1.sha256)(parsed.unsignedBytes);
+    const found = new Map();
+    for (const credential of parsed.signed.getCredentials()) {
+        if (credential._type !== sdk_1.TYPES.credential)
+            continue;
+        for (const hex of credential.getSignatures()) {
+            const address = signerOf((0, bytes_1.fromHex)(hex.replace(/^0x/, '')), digest);
+            if (address)
+                found.set((0, bytes_1.toHex)(address), address);
+        }
+    }
+    return [...found.values()];
+}
+/** avalanchejs's `Context` for this network; `fees` fills the fee fields the builder reads. */
+function sdkContext(config, fees = {}) {
+    const [bandwidth, dbRead, dbWrite, compute] = fees.weights ?? [0, 0, 0, 0];
+    return {
+        networkID: config.networkId,
+        hrp: config.hrp,
+        xBlockchainID: config.vm === 'avm' ? config.blockchainId : '',
+        pBlockchainID: config.vm === 'pvm' ? config.blockchainId : '',
+        cBlockchainID: '',
+        avaxAssetID: config.avaxAssetId,
+        baseTxFee: fees.txFee ?? 0n,
+        createAssetTxFee: 0n,
+        platformFeeConfig: {
+            weights: sdk_1.avalanche.Common.createDimensions({ bandwidth, dbRead, dbWrite, compute }),
+            maxCapacity: 0n,
+            maxPerSecond: 0n,
+            targetPerSecond: 0n,
+            minPrice: 0n,
+            excessConversionConstant: 0n,
+        },
+    };
+}
+/** The absurd-fee guard: no transfer ever pays more than `options.maxFee`. */
+function assertSaneFee(fee, config) {
+    if (fee > config.maxFee) {
+        throw new error_1.ValidationError('INVALID_INTENT', 'the fee exceeds the configured maximum (options.maxFee)');
+    }
+}
+const insufficient = (required, available) => new error_1.ChainError('INSUFFICIENT_FUNDS', 'insufficient funds for this transfer', {
+    details: { required: required.toString(), available: available.toString() },
+});
+/**
+ * A BaseTx from `from` paying `outputs`, spending the first of `utxos` (in their order)
+ * that cover the outputs and the fee, with change back to `from`. Checked before it is
+ * returned.
+ */
+function buildBaseTx(args) {
+    const { config, from, utxos, fee } = args;
+    const outputs = args.outputs.map((o) => sdk_1.avalanche.TransferableOutput.fromNative(config.avaxAssetId, o.amount, [o.to], 0n, 1));
+    const sdkUtxos = utxos.map((u) => u.sdk);
+    let tx;
+    let bytes;
+    try {
+        const unsigned = fee.model === 'static'
+            ? sdk_1.avalanche.avm.newBaseTx(sdkContext(config, { txFee: fee.txFee }), [from], sdkUtxos, outputs, {
+                changeAddresses: [from],
+                memo: args.memo,
+                minIssuanceTime: args.minIssuanceTime,
+            })
+            : sdk_1.avalanche.pvm.newBaseTx({
+                feeState: { ...fee.state, price: fee.price },
+                fromAddressesBytes: [from],
+                changeAddressesBytes: [from],
+                outputs,
+                utxos: sdkUtxos,
+                memo: args.memo,
+                minIssuanceTime: args.minIssuanceTime,
+            }, sdkContext(config, { weights: fee.weights }));
+        tx = unsigned.getTx();
+        bytes = unsigned.toBytes();
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : '';
+        const available = utxos.reduce((sum, u) => sum + u.amount, 0n);
+        const paid = args.outputs.reduce((sum, o) => sum + o.amount, 0n);
+        if (/insufficient funds/i.test(message))
+            throw insufficient(paid, available);
+        if (/exceeds capacity/i.test(message)) {
+            throw new error_1.ChainError('TX_REFUSED', 'the P-Chain has no gas capacity for this transaction now; retry later', { retryable: true });
+        }
+        throw error;
+    }
+    return checkBuilt({ ...args, tx, bytes });
+}
+const sameOwners = (owners, address) => owners.locktime.value() === 0n &&
+    owners.threshold.value() === 1 &&
+    owners.addrs.length === 1 &&
+    (0, bytes_1.equalBytes)(owners.addrs[0]?.toBytes() ?? new Uint8Array(), address);
+const sdkMismatch = (what) => new error_1.ProviderError('PROVIDER_UNAVAILABLE', `the built transaction is wrong: ${what}`, {
+    retryable: false,
+});
+function checkBuilt(args) {
+    const { config, from, tx, fee } = args;
+    const base = tx.baseTx;
+    if (!base)
+        throw sdkMismatch('no base transaction');
+    if (base.NetworkId.value() !== config.networkId ||
+        base.BlockchainId.toString() !== config.blockchainId) {
+        throw sdkMismatch('another network or chain');
+    }
+    if (!(0, bytes_1.equalBytes)(base.memo.bytes, args.memo))
+        throw sdkMismatch('the memo');
+    const offered = new Map(args.utxos.map((u) => [u.utxoId, u]));
+    const inputs = [];
+    let spent = 0n;
+    for (const input of base.inputs) {
+        const key = (0, exports.utxoKey)(input.utxoID.txID.toString(), input.utxoID.outputIdx.value());
+        const utxo = offered.get(key);
+        if (!utxo || inputs.includes(key) || input.amount() !== utxo.amount) {
+            throw sdkMismatch('an input that was not offered');
+        }
+        inputs.push(key);
+        spent += utxo.amount;
+    }
+    // Every intended output exactly once; every other output is change to the sender.
+    const pending = [...args.outputs];
+    let paid = 0n;
+    let change = 0n;
+    for (const output of base.outputs) {
+        if (output.assetId.toString() !== config.avaxAssetId ||
+            output.output._type !== sdk_1.TYPES.transferOutput) {
+            throw sdkMismatch('an output that is not plain AVAX');
+        }
+        const owners = output.output.outputOwners;
+        const amount = output.amount();
+        const index = pending.findIndex((p) => p.amount === amount && sameOwners(owners, p.to));
+        if (index !== -1) {
+            pending.splice(index, 1);
+            paid += amount;
+        }
+        else if (sameOwners(owners, from)) {
+            change += amount;
+        }
+        else {
+            throw sdkMismatch('an output to an address not asked for');
+        }
+    }
+    if (pending.length > 0)
+        throw sdkMismatch('an intended output is missing');
+    const burned = spent - paid - change;
+    let gas;
+    let expected;
+    if (fee.model === 'static') {
+        expected = fee.txFee;
+    }
+    else {
+        const weights = sdk_1.avalanche.Common.createDimensions({
+            bandwidth: fee.weights[0],
+            dbRead: fee.weights[1],
+            dbWrite: fee.weights[2],
+            compute: fee.weights[3],
+        });
+        expected = sdk_1.avalanche.pvm.calculateFee(tx, weights, fee.price);
+        gas = expected / (fee.price === 0n ? 1n : fee.price);
+    }
+    if (burned !== expected)
+        throw sdkMismatch('it burns another fee');
+    assertSaneFee(burned, config);
+    const signedSize = args.bytes.length + 4 + base.inputs.length * CREDENTIAL_BYTES;
+    if (signedSize > exports.MAX_TX_BYTES) {
+        throw new error_1.ValidationError('INVALID_INTENT', 'the transaction would exceed 64 KiB; send fewer outputs or consolidate small outputs first');
+    }
+    return {
+        bytes: args.bytes,
+        inputs: [...inputs].sort(),
+        fee: burned,
+        ...(gas !== undefined ? { gas } : {}),
+        change,
+        outputs: base.outputs.length,
+    };
+}
+/**
+ * An output that does not exist: `amount` of AVAX owned by `owner`, at a zero transaction
+ * id. Fee estimates build with it when the wallet's outputs do not cover a transfer, so the
+ * estimate still names the fee of a one-input transaction. Never spent.
+ */
+function syntheticUtxo(owner, amount, config) {
+    const asset = (0, cb58_1.cb58Decode)(config.avaxAssetId);
+    const bytes = new Uint8Array(2 + 32 + 4 + 32 + 4 + 8 + 8 + 4 + 4 + 20);
+    const view = new DataView(bytes.buffer);
+    bytes.set(asset, 38);
+    view.setUint32(70, 7); // secp256k1fx.TransferOutput, in both chains' codecs
+    view.setBigUint64(74, amount);
+    view.setUint32(90, 1); // threshold
+    view.setUint32(94, 1); // one owner
+    bytes.set(owner, 98);
+    return parseUtxo(bytes, config);
+}
+//# sourceMappingURL=codec.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"codec.js","sourceRoot":"","sources":["../../../src/adapters/avalanche/codec.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Avalanche bytes through avalanchejs: unspent outputs, signed transactions, BaseTx\n * building and credential assembly.\n * - Every parse is a round trip: bytes that do not re-encode to themselves are not taken.\n * - A transaction signs one digest, the SHA-256 of its unsigned bytes; every input's\n *   credential carries the same 65-byte recoverable signature (r, s, recovery id).\n * - A built transaction is checked before it is used (defence in depth against the SDK):\n *   its network and chain, that it spends only the outputs offered, pays every intended\n *   output exactly, sends the rest back to the sender, and burns exactly the expected fee.\n * - A transaction's senders are the addresses its signatures recover to, for every input,\n *   imported ones included.\n */\nimport { secp256k1 } from '@noble/curves/secp256k1';\nimport { ripemd160 } from '@noble/hashes/ripemd160';\nimport { sha256 } from '@noble/hashes/sha256';\nimport { ChainError, ProviderError, ValidationError } from '../../core/errors/error';\nimport { equalBytes, fromHex, toHex } from '../../core/util/bytes';\nimport { malformed } from './api';\nimport { cb58Decode, cb58Encode, idOf } from './cb58';\nimport type { AvalancheNetworkConfig } from './network';\nimport {\n  TYPES,\n  avalanche,\n  type SdkContext,\n  type SdkFeeState,\n  type SdkOutputOwners,\n  type SdkSignedTx,\n  type SdkTransaction,\n  type SdkTransferOutput,\n  type SdkUtxo,\n} from './sdk';\nimport type { FeeWeights } from './api';\n\n/** AvalancheGo's mempool refuses a transaction of more bytes (`MaxTxSize`, 64 KiB). */\nexport const MAX_TX_BYTES = 64 * 1024;\n/** A secp256k1 credential of one signature: type id, count and the signature. */\nconst CREDENTIAL_BYTES = 4 + 4 + 65;\n/** `avax.MaxMemoSize`. */\nexport const MAX_MEMO_BYTES = 256;\n\nconst vmName = (config: Pick<AvalancheNetworkConfig, 'vm'>): 'AVM' | 'PVM' =>\n  config.vm === 'avm' ? 'AVM' : 'PVM';\n\n/** A reservation key: `txID:outputIndex`. */\nexport const utxoKey = (txId: string, outputIndex: number): string =>\n  `${txId}:${outputIndex}`;\n\n/** The `utxoId` of raw UTXO bytes: codec (2), txID (32), output index (4) lead them all. */\nexport function utxoKeyOf(bytes: Uint8Array): string {\n  if (bytes.length < 38) throw malformed('utxo');\n  const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);\n  return utxoKey(cb58Encode(bytes.subarray(2, 34)), view.getUint32(34));\n}\n\n/** An unspent output, read from the node's bytes. */\nexport interface ParsedUtxo {\n  readonly utxoId: string;\n  readonly txId: string;\n  readonly outputIndex: number;\n  readonly assetId: string;\n  readonly amount: bigint;\n  readonly locktime: bigint;\n  readonly threshold: number;\n  readonly owners: readonly Uint8Array[];\n  /** A `secp256k1fx.TransferOutput` (not stake-locked, minted or an NFT). */\n  readonly plain: boolean;\n  readonly sdk: SdkUtxo;\n}\n\nconst hasAmount = (value: unknown): value is { amount(): bigint } =>\n  typeof (value as { amount?: unknown }).amount === 'function';\n\nfunction ownersOf(output: { readonly _type: string }): SdkOutputOwners | undefined {\n  if (output._type === TYPES.transferOutput) {\n    return (output as SdkTransferOutput).outputOwners;\n  }\n  if (output._type === TYPES.stakeableLockOut) {\n    const inner = (output as unknown as { transferOut: { _type: string } }).transferOut;\n    return inner._type === TYPES.transferOutput\n      ? (inner as SdkTransferOutput).outputOwners\n      : undefined;\n  }\n  return undefined;\n}\n\nexport function parseUtxo(\n  bytes: Uint8Array,\n  config: Pick<AvalancheNetworkConfig, 'vm'>,\n): ParsedUtxo {\n  const manager = avalanche.utils.getManagerForVM(vmName(config));\n  let utxo: SdkUtxo;\n  try {\n    utxo = manager.unpack(bytes, avalanche.Utxo);\n  } catch {\n    throw malformed('utxo');\n  }\n  const reencoded = (() => {\n    try {\n      return new Uint8Array([0, 0, ...utxo.toBytes(manager.getDefaultCodec())]);\n    } catch {\n      throw malformed('utxo');\n    }\n  })();\n  if (!equalBytes(reencoded, bytes)) throw malformed('utxo');\n  const owners = ownersOf(utxo.output);\n  const plain = utxo.output._type === TYPES.transferOutput;\n  const amount = hasAmount(utxo.output) ? utxo.output.amount() : 0n;\n  const locktime =\n    utxo.output._type === TYPES.stakeableLockOut\n      ? (utxo.output as unknown as { getLocktime(): bigint }).getLocktime()\n      : (owners?.locktime.value() ?? 0n);\n  const txId = utxo.utxoId.txID.toString();\n  const outputIndex = utxo.utxoId.outputIdx.value();\n  return {\n    utxoId: utxoKey(txId, outputIndex),\n    txId,\n    outputIndex,\n    assetId: utxo.assetId.toString(),\n    amount,\n    locktime,\n    threshold: owners?.threshold.value() ?? 0,\n    owners: owners?.addrs.map((a) => a.toBytes()) ?? [],\n    plain,\n    sdk: utxo,\n  };\n}\n\n/** Whether a transfer from `from` may spend `utxo`: plain AVAX, unlocked, `from` alone signs. */\nexport function spendableBy(\n  utxo: ParsedUtxo,\n  from: Uint8Array,\n  config: Pick<AvalancheNetworkConfig, 'avaxAssetId'>,\n): boolean {\n  return (\n    utxo.plain &&\n    utxo.assetId === config.avaxAssetId &&\n    utxo.amount > 0n &&\n    utxo.locktime === 0n &&\n    utxo.threshold === 1 &&\n    utxo.owners.some((owner) => equalBytes(owner, from))\n  );\n}\n\n/** Signed transaction bytes, parsed; their unsigned part re-encoded. */\nexport interface ParsedTx {\n  readonly id: string;\n  readonly signed: SdkSignedTx;\n  readonly tx: SdkTransaction;\n  readonly unsignedBytes: Uint8Array;\n}\n\nexport function parseSignedTx(\n  bytes: Uint8Array,\n  config: Pick<AvalancheNetworkConfig, 'vm'>,\n): ParsedTx {\n  const manager = avalanche.utils.getManagerForVM(vmName(config));\n  let signed: SdkSignedTx;\n  let reencoded: Uint8Array;\n  let unsignedBytes: Uint8Array;\n  try {\n    signed = manager.unpack(bytes, avalanche.avaxSerial.SignedTx);\n    reencoded = signed.toBytes();\n    unsignedBytes = manager.packCodec(signed.unsignedTx);\n  } catch {\n    throw malformed('transaction');\n  }\n  if (\n    !equalBytes(reencoded, bytes) ||\n    !equalBytes(bytes.subarray(0, unsignedBytes.length), unsignedBytes)\n  ) {\n    throw malformed('transaction');\n  }\n  return { id: idOf(bytes), signed, tx: signed.unsignedTx, unsignedBytes };\n}\n\n/** The unsigned transaction in `bytes` (a prepared payload), re-encoded exactly. */\nexport function parseUnsignedTx(\n  bytes: Uint8Array,\n  config: Pick<AvalancheNetworkConfig, 'vm'>,\n): SdkTransaction {\n  const manager = avalanche.utils.getManagerForVM(vmName(config));\n  let tx: SdkTransaction;\n  try {\n    tx = manager.unpackTransaction(bytes);\n    if (!equalBytes(manager.packCodec(tx), bytes)) throw new Error('not exact');\n  } catch {\n    throw new ValidationError(\n      'INVALID_INTENT',\n      'not an unsigned transaction of this chain',\n    );\n  }\n  return tx;\n}\n\n/** `r ‖ s ‖ v`: a 64-byte compact signature and its recovery id, as credentials hold them. */\nexport function credentialSignature(compact: Uint8Array, recovery: number): Uint8Array {\n  const out = new Uint8Array(65);\n  out.set(compact, 0);\n  out[64] = recovery;\n  return out;\n}\n\n/** The signed bytes: every input's credential carries `signature` once per signer index. */\nexport function assembleSigned(\n  unsignedBytes: Uint8Array,\n  signature: Uint8Array,\n  config: Pick<AvalancheNetworkConfig, 'vm'>,\n): Uint8Array {\n  const tx = parseUnsignedTx(unsignedBytes, config);\n  const credentials = tx\n    .getSigIndices()\n    .map(\n      (indices) =>\n        new avalanche.Credential(indices.map(() => new avalanche.Signature(signature))),\n    );\n  return new avalanche.avaxSerial.SignedTx(tx, credentials).toBytes();\n}\n\n/** The 20-byte address a 65-byte signature over `digest` recovers to, if any. */\nfunction signerOf(signature: Uint8Array, digest: Uint8Array): Uint8Array | undefined {\n  if (signature.length !== 65 || (signature[64] as number) > 3) return undefined;\n  try {\n    const publicKey = secp256k1.Signature.fromCompact(signature.subarray(0, 64))\n      .addRecoveryBit(signature[64] as number)\n      .recoverPublicKey(digest)\n      .toRawBytes(true);\n    return ripemd160(sha256(publicKey));\n  } catch {\n    return undefined;\n  }\n}\n\n/** The addresses that signed `parsed`, once each, in credential order. */\nexport function signersOf(parsed: ParsedTx): Uint8Array[] {\n  const digest = sha256(parsed.unsignedBytes);\n  const found = new Map<string, Uint8Array>();\n  for (const credential of parsed.signed.getCredentials()) {\n    if (credential._type !== TYPES.credential) continue;\n    for (const hex of credential.getSignatures()) {\n      const address = signerOf(fromHex(hex.replace(/^0x/, '')), digest);\n      if (address) found.set(toHex(address), address);\n    }\n  }\n  return [...found.values()];\n}\n\n/** avalanchejs's `Context` for this network; `fees` fills the fee fields the builder reads. */\nexport function sdkContext(\n  config: AvalancheNetworkConfig,\n  fees: { readonly txFee?: bigint; readonly weights?: FeeWeights } = {},\n): SdkContext {\n  const [bandwidth, dbRead, dbWrite, compute] = fees.weights ?? [0, 0, 0, 0];\n  return {\n    networkID: config.networkId,\n    hrp: config.hrp,\n    xBlockchainID: config.vm === 'avm' ? config.blockchainId : '',\n    pBlockchainID: config.vm === 'pvm' ? config.blockchainId : '',\n    cBlockchainID: '',\n    avaxAssetID: config.avaxAssetId,\n    baseTxFee: fees.txFee ?? 0n,\n    createAssetTxFee: 0n,\n    platformFeeConfig: {\n      weights: avalanche.Common.createDimensions({ bandwidth, dbRead, dbWrite, compute }),\n      maxCapacity: 0n,\n      maxPerSecond: 0n,\n      targetPerSecond: 0n,\n      minPrice: 0n,\n      excessConversionConstant: 0n,\n    },\n  };\n}\n\nexport type FeePlan =\n  | { readonly model: 'static'; readonly txFee: bigint }\n  | {\n      readonly model: 'dynamic';\n      readonly price: bigint;\n      readonly state: SdkFeeState;\n      readonly weights: FeeWeights;\n    };\n\nexport interface PlannedOutput {\n  readonly to: Uint8Array;\n  readonly amount: bigint;\n}\n\nexport interface BuiltTx {\n  /** The unsigned bytes (codec version and transaction). */\n  readonly bytes: Uint8Array;\n  readonly inputs: readonly string[];\n  readonly fee: bigint;\n  /** P-Chain: the gas the transaction uses. */\n  readonly gas?: bigint;\n  readonly change: bigint;\n  readonly outputs: number;\n}\n\n/** The absurd-fee guard: no transfer ever pays more than `options.maxFee`. */\nexport function assertSaneFee(\n  fee: bigint,\n  config: Pick<AvalancheNetworkConfig, 'maxFee'>,\n): void {\n  if (fee > config.maxFee) {\n    throw new ValidationError(\n      'INVALID_INTENT',\n      'the fee exceeds the configured maximum (options.maxFee)',\n    );\n  }\n}\n\nconst insufficient = (required: bigint, available: bigint): ChainError =>\n  new ChainError('INSUFFICIENT_FUNDS', 'insufficient funds for this transfer', {\n    details: { required: required.toString(), available: available.toString() },\n  });\n\n/**\n * A BaseTx from `from` paying `outputs`, spending the first of `utxos` (in their order)\n * that cover the outputs and the fee, with change back to `from`. Checked before it is\n * returned.\n */\nexport function buildBaseTx(args: {\n  readonly config: AvalancheNetworkConfig;\n  readonly from: Uint8Array;\n  readonly utxos: readonly ParsedUtxo[];\n  readonly outputs: readonly PlannedOutput[];\n  readonly memo: Uint8Array;\n  readonly minIssuanceTime: bigint;\n  readonly fee: FeePlan;\n}): BuiltTx {\n  const { config, from, utxos, fee } = args;\n  const outputs = args.outputs.map((o) =>\n    avalanche.TransferableOutput.fromNative(config.avaxAssetId, o.amount, [o.to], 0n, 1),\n  );\n  const sdkUtxos = utxos.map((u) => u.sdk);\n  let tx: SdkTransaction;\n  let bytes: Uint8Array;\n  try {\n    const unsigned =\n      fee.model === 'static'\n        ? avalanche.avm.newBaseTx(\n            sdkContext(config, { txFee: fee.txFee }),\n            [from],\n            sdkUtxos,\n            outputs,\n            {\n              changeAddresses: [from],\n              memo: args.memo,\n              minIssuanceTime: args.minIssuanceTime,\n            },\n          )\n        : avalanche.pvm.newBaseTx(\n            {\n              feeState: { ...fee.state, price: fee.price },\n              fromAddressesBytes: [from],\n              changeAddressesBytes: [from],\n              outputs,\n              utxos: sdkUtxos,\n              memo: args.memo,\n              minIssuanceTime: args.minIssuanceTime,\n            },\n            sdkContext(config, { weights: fee.weights }),\n          );\n    tx = unsigned.getTx();\n    bytes = unsigned.toBytes();\n  } catch (error) {\n    const message = error instanceof Error ? error.message : '';\n    const available = utxos.reduce((sum, u) => sum + u.amount, 0n);\n    const paid = args.outputs.reduce((sum, o) => sum + o.amount, 0n);\n    if (/insufficient funds/i.test(message)) throw insufficient(paid, available);\n    if (/exceeds capacity/i.test(message)) {\n      throw new ChainError(\n        'TX_REFUSED',\n        'the P-Chain has no gas capacity for this transaction now; retry later',\n        { retryable: true },\n      );\n    }\n    throw error;\n  }\n  return checkBuilt({ ...args, tx, bytes });\n}\n\nconst sameOwners = (owners: SdkOutputOwners, address: Uint8Array): boolean =>\n  owners.locktime.value() === 0n &&\n  owners.threshold.value() === 1 &&\n  owners.addrs.length === 1 &&\n  equalBytes(owners.addrs[0]?.toBytes() ?? new Uint8Array(), address);\n\nconst sdkMismatch = (what: string): ProviderError =>\n  new ProviderError('PROVIDER_UNAVAILABLE', `the built transaction is wrong: ${what}`, {\n    retryable: false,\n  });\n\nfunction checkBuilt(args: {\n  readonly config: AvalancheNetworkConfig;\n  readonly from: Uint8Array;\n  readonly utxos: readonly ParsedUtxo[];\n  readonly outputs: readonly PlannedOutput[];\n  readonly memo: Uint8Array;\n  readonly fee: FeePlan;\n  readonly tx: SdkTransaction;\n  readonly bytes: Uint8Array;\n}): BuiltTx {\n  const { config, from, tx, fee } = args;\n  const base = tx.baseTx;\n  if (!base) throw sdkMismatch('no base transaction');\n  if (\n    base.NetworkId.value() !== config.networkId ||\n    base.BlockchainId.toString() !== config.blockchainId\n  ) {\n    throw sdkMismatch('another network or chain');\n  }\n  if (!equalBytes(base.memo.bytes, args.memo)) throw sdkMismatch('the memo');\n  const offered = new Map(args.utxos.map((u) => [u.utxoId, u]));\n  const inputs: string[] = [];\n  let spent = 0n;\n  for (const input of base.inputs) {\n    const key = utxoKey(input.utxoID.txID.toString(), input.utxoID.outputIdx.value());\n    const utxo = offered.get(key);\n    if (!utxo || inputs.includes(key) || input.amount() !== utxo.amount) {\n      throw sdkMismatch('an input that was not offered');\n    }\n    inputs.push(key);\n    spent += utxo.amount;\n  }\n  // Every intended output exactly once; every other output is change to the sender.\n  const pending = [...args.outputs];\n  let paid = 0n;\n  let change = 0n;\n  for (const output of base.outputs) {\n    if (\n      output.assetId.toString() !== config.avaxAssetId ||\n      output.output._type !== TYPES.transferOutput\n    ) {\n      throw sdkMismatch('an output that is not plain AVAX');\n    }\n    const owners = (output.output as SdkTransferOutput).outputOwners;\n    const amount = output.amount();\n    const index = pending.findIndex(\n      (p) => p.amount === amount && sameOwners(owners, p.to),\n    );\n    if (index !== -1) {\n      pending.splice(index, 1);\n      paid += amount;\n    } else if (sameOwners(owners, from)) {\n      change += amount;\n    } else {\n      throw sdkMismatch('an output to an address not asked for');\n    }\n  }\n  if (pending.length > 0) throw sdkMismatch('an intended output is missing');\n  const burned = spent - paid - change;\n  let gas: bigint | undefined;\n  let expected: bigint;\n  if (fee.model === 'static') {\n    expected = fee.txFee;\n  } else {\n    const weights = avalanche.Common.createDimensions({\n      bandwidth: fee.weights[0],\n      dbRead: fee.weights[1],\n      dbWrite: fee.weights[2],\n      compute: fee.weights[3],\n    });\n    expected = avalanche.pvm.calculateFee(tx, weights, fee.price);\n    gas = expected / (fee.price === 0n ? 1n : fee.price);\n  }\n  if (burned !== expected) throw sdkMismatch('it burns another fee');\n  assertSaneFee(burned, config);\n  const signedSize = args.bytes.length + 4 + base.inputs.length * CREDENTIAL_BYTES;\n  if (signedSize > MAX_TX_BYTES) {\n    throw new ValidationError(\n      'INVALID_INTENT',\n      'the transaction would exceed 64 KiB; send fewer outputs or consolidate small outputs first',\n    );\n  }\n  return {\n    bytes: args.bytes,\n    inputs: [...inputs].sort(),\n    fee: burned,\n    ...(gas !== undefined ? { gas } : {}),\n    change,\n    outputs: base.outputs.length,\n  };\n}\n\n/**\n * An output that does not exist: `amount` of AVAX owned by `owner`, at a zero transaction\n * id. Fee estimates build with it when the wallet's outputs do not cover a transfer, so the\n * estimate still names the fee of a one-input transaction. Never spent.\n */\nexport function syntheticUtxo(\n  owner: Uint8Array,\n  amount: bigint,\n  config: Pick<AvalancheNetworkConfig, 'vm' | 'avaxAssetId'>,\n): ParsedUtxo {\n  const asset = cb58Decode(config.avaxAssetId) as Uint8Array;\n  const bytes = new Uint8Array(2 + 32 + 4 + 32 + 4 + 8 + 8 + 4 + 4 + 20);\n  const view = new DataView(bytes.buffer);\n  bytes.set(asset, 38);\n  view.setUint32(70, 7); // secp256k1fx.TransferOutput, in both chains' codecs\n  view.setBigUint64(74, amount);\n  view.setUint32(90, 1); // threshold\n  view.setUint32(94, 1); // one owner\n  bytes.set(owner, 98);\n  return parseUtxo(bytes, config);\n}\n"]}

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

@@ -0,0 +1,59 @@
+/**
+ * What every Avalanche port is built from, the transport tags of the `ChainDriver` contract
+ * table, and the locator: which accepted block holds a transaction.
+ *
+ * AvalancheGo can say a transaction is accepted, never in which block. The locator asks the
+ * Data API, then checks the answer against the node's block; a transaction the indexer does
+ * not know yet (it trails the chain by seconds) is looked for in the newest `SCAN_DEPTH`
+ * blocks. Accepted blocks never change (Snowman finality), so a location is kept once found.
+ * A location found on one endpoint is only a candidate for proofs: every proof re-reads its
+ * block under the proof quorum, and a candidate the quorum contradicts is forgotten.
+ */
+import { ProviderError } from '../../core/errors/error';
+import type { Logger } from '../../core/events/logger';
+import type { ChainInfo, NetworkInfo } from '../../core/model/chain';
+import type { Clock } from '../../core/util/clock';
+import type { AvalancheNode, DataApi, Location } from './api';
+import type { AvalancheNetworkConfig } from './network';
+import type { AvalancheCallTags } from './types';
+export declare const READ: AvalancheCallTags;
+export declare const MONITOR: AvalancheCallTags;
+export declare const PROOF: AvalancheCallTags;
+export declare const withSignal: (tags: AvalancheCallTags, signal?: AbortSignal) => AvalancheCallTags;
+/** How many blocks below the head the locator reads when the indexer does not know a tx. */
+export declare const SCAN_DEPTH = 16;
+export declare class LocationCache {
+    #private;
+    get(txId: string): Location | undefined;
+    set(txId: string, location: Location): void;
+    forget(txId: string): void;
+}
+export interface AvalancheContext {
+    readonly node: AvalancheNode;
+    readonly dataApi: DataApi;
+    readonly chain: ChainInfo;
+    readonly network: NetworkInfo;
+    readonly config: AvalancheNetworkConfig;
+    readonly clock: Clock;
+    readonly log: Logger;
+    readonly located: LocationCache;
+}
+export declare const undecided: (reason: string) => ProviderError;
+/** Two reads that cannot both hold decide nothing (retryable). */
+export declare const contradiction: (reason: string) => ProviderError;
+/**
+ * On a proof path only a definitive negative proof may answer "no".
+ * Every other non-retryable provider error (a JSON-RPC error that is not a "not found" the
+ * caller already mapped, a proxy's 4xx, a 401/403) becomes a retryable
+ * `PROVIDER_UNAVAILABLE` here, so it never decides anything. Retryable errors pass as they
+ * are. The cost is liveness only.
+ */
+export declare function proofRead<T>(read: () => Promise<T>): Promise<T>;
+/**
+ * The accepted block holding `txId`, a transaction the node has accepted: from the cache,
+ * else the indexer (checked against the node's block at its height), else the newest
+ * `SCAN_DEPTH` blocks. `undefined` when none of them names it yet, `'no-block'` for an
+ * X-Chain transaction from before the chain had blocks. Reads are single
+ * (`monitor` or `read`) reads: a location is a candidate; proofs re-read it under quorum.
+ */
+export declare function locate(ctx: AvalancheContext, txId: string, tags: AvalancheCallTags): Promise<Location | 'no-block' | undefined>;