verus-rpc 0.1.0

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,MAAM,sBAAsB,GAAG,SAAS,GAAG,SAAS,GAAG,cAAc,GAAG,cAAc,CAAC;AAE7F,qBAAa,cAAe,SAAQ,KAAK;IACvC,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC;gBAE5B,MAAM,EAAE,sBAAsB,EAAE,OAAO,EAAE,MAAM;CAK5D;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmCf,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC;AAE5E,+DAA+D;AAC/D,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAM1D;AAED;;;;GAIG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBAEX,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAM3D;AAED,qFAAqF;AACrF,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;gBAEtB,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM;CAOpF;AAED,gGAAgG;AAChG,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAK5C"}

package/dist/errors.js

@@ -0,0 +1,107 @@
+/**
+ * Error taxonomy — the split matters for resilience:
+ *
+ * - `VerusRpcError` — the daemon answered with a JSON-RPC error (bad params,
+ *   unknown identity, insufficient funds, …). The node is HEALTHY; these never
+ *   count toward the optional circuit breaker, otherwise malformed requests
+ *   could trip it and deny service (v402 lesson).
+ * - `TransportError` — the node could not be reached, did not answer in time,
+ *   answered with an unparseable body, or the breaker is open.
+ */
+export class TransportError extends Error {
+    reason;
+    constructor(reason, message) {
+        super(message);
+        this.name = "TransportError";
+        this.reason = reason;
+    }
+}
+/**
+ * Common daemon error codes (Bitcoin/Zcash lineage, `rpcprotocol.h`) so
+ * consumers can branch on `error.code` without string-matching messages.
+ */
+export const RpcErrorCode = {
+    // JSON-RPC 2.0-style protocol errors
+    RPC_INVALID_REQUEST: -32600,
+    RPC_METHOD_NOT_FOUND: -32601,
+    RPC_INVALID_PARAMS: -32602,
+    RPC_INTERNAL_ERROR: -32603,
+    RPC_PARSE_ERROR: -32700,
+    // General application errors
+    RPC_MISC_ERROR: -1,
+    RPC_FORBIDDEN_BY_SAFE_MODE: -2,
+    RPC_TYPE_ERROR: -3,
+    RPC_INVALID_ADDRESS_OR_KEY: -5,
+    RPC_OUT_OF_MEMORY: -7,
+    RPC_INVALID_PARAMETER: -8,
+    RPC_DATABASE_ERROR: -20,
+    RPC_DESERIALIZATION_ERROR: -22,
+    RPC_VERIFY_ERROR: -25,
+    RPC_VERIFY_REJECTED: -26,
+    RPC_VERIFY_ALREADY_IN_CHAIN: -27,
+    RPC_IN_WARMUP: -28,
+    // P2P client errors
+    RPC_CLIENT_NOT_CONNECTED: -9,
+    RPC_CLIENT_IN_INITIAL_DOWNLOAD: -10,
+    RPC_CLIENT_NODE_ALREADY_ADDED: -23,
+    RPC_CLIENT_NODE_NOT_ADDED: -24,
+    // Wallet errors
+    RPC_WALLET_ERROR: -4,
+    RPC_WALLET_INSUFFICIENT_FUNDS: -6,
+    RPC_WALLET_INVALID_ACCOUNT_NAME: -11,
+    RPC_WALLET_KEYPOOL_RAN_OUT: -12,
+    RPC_WALLET_UNLOCK_NEEDED: -13,
+    RPC_WALLET_PASSPHRASE_INCORRECT: -14,
+    RPC_WALLET_WRONG_ENC_STATE: -15,
+    RPC_WALLET_ENCRYPTION_FAILED: -16,
+    RPC_WALLET_ALREADY_UNLOCKED: -17,
+};
+/** The daemon answered the call with a JSON-RPC error body. */
+export class VerusRpcError extends Error {
+    method;
+    code;
+    constructor(method, code, message) {
+        super(`${method}: ${message} (code ${code})`);
+        this.name = "VerusRpcError";
+        this.method = method;
+        this.code = code;
+    }
+}
+/**
+ * A curated (T1) response did not have the shape the mapper expects — the
+ * daemon version drifted or the type curation is wrong. The raw value is
+ * intact on the wire; `client.call()` always works as the escape hatch.
+ */
+export class ResponseMappingError extends Error {
+    method;
+    field;
+    constructor(method, field, message) {
+        super(`${method}: field "${field}": ${message}`);
+        this.name = "ResponseMappingError";
+        this.method = method;
+        this.field = field;
+    }
+}
+/** An async wallet operation (opid) finished with status "failed" or "cancelled". */
+export class OperationFailedError extends Error {
+    opid;
+    status;
+    code;
+    constructor(opid, status, code, message) {
+        super(`operation ${opid} ${status}: ${message}`);
+        this.name = "OperationFailedError";
+        this.opid = opid;
+        this.status = status;
+        this.code = code;
+    }
+}
+/** An async wallet operation (opid) did not reach a final state within the polling deadline. */
+export class OperationTimeoutError extends Error {
+    opid;
+    constructor(opid, timeoutMs) {
+        super(`operation ${opid} still pending after ${timeoutMs}ms`);
+        this.name = "OperationTimeoutError";
+        this.opid = opid;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+export { formatAmount, parseAmount, SATS_PER_COIN, type ParseAmountOptions } from "./amount.js";
+export { OperationFailedError, OperationTimeoutError, ResponseMappingError, RpcErrorCode, TransportError, VerusRpcError, type TransportFailureReason, } from "./errors.js";
+export { isLosslessNumber, LosslessNumber, toJsNumbers, toSafeNumbers } from "./lossless.js";
+export { DaemonTransport, type DaemonTransportConfig, type RpcTransport } from "./transport.js";
+export { withResilience, type ResilienceConfig } from "./resilience.js";
+export { MockTransport } from "./mock.js";
+export { VerusClient, type CallNumbersMode, type CallOptions, type VerusClientConfig, } from "./client.js";
+export { ChainApi, mapGetInfo, type GetInfoResult } from "./methods/chain.js";
+export { AddressIndexApi, mapAddressBalance, mapAddressDelta, mapAddressUtxo, type AddressBalanceResult, type AddressDelta, type AddressRangeOptions, type AddressUtxo, } from "./methods/addressindex.js";
+export { BlockchainApi, mapGetVdxfId, type CreateRawTransactionInput, type GetVdxfIdResult, type RawTransactionOptions, } from "./methods/blockchain.js";
+export { ShieldedApi, type WaitForOperationOptions, type ZReceivedEntry, type ZSendManyEntry, type ZSendManyOptions, type ZTotalBalanceResult, type ZUnspentEntry, } from "./methods/shielded.js";
+export { CurrencyApi, mapConversionEstimate, mapCurrencyConverterEntry, mapCurrencyDefinition, mapCurrencyState, type ConversionEstimate, type CurrencyConversionData, type CurrencyConverterEntry, type CurrencyDefinition, type CurrencyState, type CurrencyStateSnapshot, type EstimateConversionOptions, type GetCurrencyOptions, type GetCurrencyStateOptions, type ListCurrenciesEntry, type ListCurrenciesOptions, type ListCurrenciesQuery, type ReserveCurrencyState, } from "./methods/currency.js";
+export { IdentityApi, mapGetIdentity, mapIdentityDefinition, mapIdentityHistory, mapIdentityResult, mapNameCommitment, type GetIdentityContentOptions, type GetIdentityHistoryOptions, type GetIdentityHistoryResult, type GetIdentityOptions, type GetIdentityResult, type IdentitiesByAddressQuery, type IdentitiesByAuthorityQuery, type IdentityDefinition, type IdentityHistoryEntry, type IdentitySpec, type IndexedIdentity, type ListIdentitiesOptions, type NameCommitmentResult, type NameReservation, type RecoverIdentityOptions, type RegisterIdentityFlowOptions, type RegisterIdentityFlowResult, type RegisterIdentityOptions, type RegisterNameCommitmentOptions, type RevokeIdentityOptions, type SetIdentityTimelockOptions, type SignFileOptions, type UpdateIdentityOptions, } from "./methods/identity.js";
+export type { GetWalletInfoResult, GroupedAddress, ImportAddressOptions, ImportPrivKeyOptions, ListReceivedOptions, ListTransactionsOptions, ListUnspentOptions, ListedTransaction, ReceivedByAddressEntry, SendManyOptions, SignMessageOptions, SignMessageResult, UnspentOutput, VerifyMessageOptions, } from "./methods/wallet-types.js";
+export { WalletApi, mapAddressGroupings, mapCurrencyBalance, mapGetTransaction, mapGetWalletInfo, mapListedTransaction, mapOperationStatus, mapSignMessage, mapUnspentOutput, type GetBalanceOptions, type GetCurrencyBalanceOptions, type GetOperationStatusOptions, type GetTransactionOptions, type GetTransactionResult, type OperationError, type OperationResult, type OperationStatus, type SendCurrencyAndWaitOptions, type SendCurrencyAndWaitResult, type SendCurrencyOptions, type SendCurrencyOutput, type TransactionDetail, } from "./methods/wallet.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,21 @@
+// verus-rpc — the npm-published, full-coverage, precision-honest TypeScript
+// client for talking to your own verusd.
+//
+// Invariant: no float ever crosses this API for a value field. Curated (T1)
+// methods surface amounts as bigint satoshis; typed (T2) methods as exact
+// decimal strings; `call()` is the always-available escape hatch.
+export { formatAmount, parseAmount, SATS_PER_COIN } from "./amount.js";
+export { OperationFailedError, OperationTimeoutError, ResponseMappingError, RpcErrorCode, TransportError, VerusRpcError, } from "./errors.js";
+export { isLosslessNumber, LosslessNumber, toJsNumbers, toSafeNumbers } from "./lossless.js";
+export { DaemonTransport } from "./transport.js";
+export { withResilience } from "./resilience.js";
+export { MockTransport } from "./mock.js";
+export { VerusClient, } from "./client.js";
+export { ChainApi, mapGetInfo } from "./methods/chain.js";
+export { AddressIndexApi, mapAddressBalance, mapAddressDelta, mapAddressUtxo, } from "./methods/addressindex.js";
+export { BlockchainApi, mapGetVdxfId, } from "./methods/blockchain.js";
+export { ShieldedApi, } from "./methods/shielded.js";
+export { CurrencyApi, mapConversionEstimate, mapCurrencyConverterEntry, mapCurrencyDefinition, mapCurrencyState, } from "./methods/currency.js";
+export { IdentityApi, mapGetIdentity, mapIdentityDefinition, mapIdentityHistory, mapIdentityResult, mapNameCommitment, } from "./methods/identity.js";
+export { WalletApi, mapAddressGroupings, mapCurrencyBalance, mapGetTransaction, mapGetWalletInfo, mapListedTransaction, mapOperationStatus, mapSignMessage, mapUnspentOutput, } from "./methods/wallet.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,yCAAyC;AACzC,EAAE;AACF,4EAA4E;AAC5E,0EAA0E;AAC1E,kEAAkE;AAElE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAA2B,MAAM,aAAa,CAAC;AAChG,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,YAAY,EACZ,cAAc,EACd,aAAa,GAEd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC7F,OAAO,EAAE,eAAe,EAAiD,MAAM,gBAAgB,CAAC;AAChG,OAAO,EAAE,cAAc,EAAyB,MAAM,iBAAiB,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EACL,WAAW,GAIZ,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAsB,MAAM,oBAAoB,CAAC;AAC9E,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,cAAc,GAKf,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,aAAa,EACb,YAAY,GAIb,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,WAAW,GAOZ,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,WAAW,EACX,qBAAqB,EACrB,yBAAyB,EACzB,qBAAqB,EACrB,gBAAgB,GAcjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,WAAW,EACX,cAAc,EACd,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,GAwBlB,MAAM,uBAAuB,CAAC;AAiB/B,OAAO,EACL,SAAS,EACT,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,gBAAgB,GAcjB,MAAM,qBAAqB,CAAC"}

package/dist/lossless.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Lossless JSON layer — the daemon emits value amounts as JSON decimal
+ * numbers (`{"VRSCTEST":2.00000000}`), so the transport never runs them
+ * through `JSON.parse`'s float64. Number literals survive parsing as
+ * `LosslessNumber` (exact decimal string inside) until a mapper decides what
+ * they are.
+ */
+import { isLosslessNumber, LosslessNumber } from "lossless-json";
+export { isLosslessNumber, LosslessNumber };
+/** Parse JSON text with number literals preserved as `LosslessNumber`. */
+export declare function parseLossless(text: string): unknown;
+/**
+ * Serialize a request/params tree. `LosslessNumber` and `bigint` nodes are
+ * written as exact JSON number tokens — outbound amounts keep full precision
+ * without relying on the daemon accepting strings for numeric params.
+ */
+export declare function stringifyLossless(value: unknown): string;
+/**
+ * Deep-convert `LosslessNumber` nodes for surfaces without curated types
+ * (unknown T1 passthrough fields, `call()` in "lossless" mode):
+ * safe integers become `number`, everything else (fractional values,
+ * integers beyond 2^53) becomes an exact decimal `string`. No float64
+ * rounding can occur.
+ */
+export declare function toSafeNumbers(tree: unknown): unknown;
+/**
+ * Deep-convert `LosslessNumber` nodes to plain JS `number` — classic
+ * `JSON.parse` semantics. Float64 rounding applies; documented as unsafe for
+ * arithmetic on amounts. Used by `call()` in "js" mode only.
+ */
+export declare function toJsNumbers(tree: unknown): unknown;
+//# sourceMappingURL=lossless.d.ts.map

package/dist/lossless.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lossless.d.ts","sourceRoot":"","sources":["../src/lossless.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAoB,MAAM,eAAe,CAAC;AAEnF,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,CAAC;AAE5C,0EAA0E;AAC1E,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAMxD;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAMpD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAElD"}

package/dist/lossless.js

@@ -0,0 +1,64 @@
+/**
+ * Lossless JSON layer — the daemon emits value amounts as JSON decimal
+ * numbers (`{"VRSCTEST":2.00000000}`), so the transport never runs them
+ * through `JSON.parse`'s float64. Number literals survive parsing as
+ * `LosslessNumber` (exact decimal string inside) until a mapper decides what
+ * they are.
+ */
+import { isLosslessNumber, LosslessNumber, parse, stringify } from "lossless-json";
+export { isLosslessNumber, LosslessNumber };
+/** Parse JSON text with number literals preserved as `LosslessNumber`. */
+export function parseLossless(text) {
+    return parse(text);
+}
+/**
+ * Serialize a request/params tree. `LosslessNumber` and `bigint` nodes are
+ * written as exact JSON number tokens — outbound amounts keep full precision
+ * without relying on the daemon accepting strings for numeric params.
+ */
+export function stringifyLossless(value) {
+    const text = stringify(value);
+    if (text === undefined) {
+        throw new TypeError("value is not serializable to JSON");
+    }
+    return text;
+}
+/**
+ * Deep-convert `LosslessNumber` nodes for surfaces without curated types
+ * (unknown T1 passthrough fields, `call()` in "lossless" mode):
+ * safe integers become `number`, everything else (fractional values,
+ * integers beyond 2^53) becomes an exact decimal `string`. No float64
+ * rounding can occur.
+ */
+export function toSafeNumbers(tree) {
+    return transformNumbers(tree, (ln) => {
+        const text = ln.toString();
+        const value = Number(text);
+        return Number.isSafeInteger(value) && String(value) === text ? value : text;
+    });
+}
+/**
+ * Deep-convert `LosslessNumber` nodes to plain JS `number` — classic
+ * `JSON.parse` semantics. Float64 rounding applies; documented as unsafe for
+ * arithmetic on amounts. Used by `call()` in "js" mode only.
+ */
+export function toJsNumbers(tree) {
+    return transformNumbers(tree, (ln) => Number(ln.toString()));
+}
+function transformNumbers(tree, convert) {
+    if (isLosslessNumber(tree)) {
+        return convert(tree);
+    }
+    if (Array.isArray(tree)) {
+        return tree.map((item) => transformNumbers(item, convert));
+    }
+    if (tree !== null && typeof tree === "object") {
+        const out = {};
+        for (const [key, value] of Object.entries(tree)) {
+            out[key] = transformNumbers(value, convert);
+        }
+        return out;
+    }
+    return tree;
+}
+//# sourceMappingURL=lossless.js.map

package/dist/lossless.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lossless.js","sourceRoot":"","sources":["../src/lossless.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAEnF,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,CAAC;AAE5C,0EAA0E;AAC1E,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC;AACrB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAC9B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,IAAI,SAAS,CAAC,mCAAmC,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,IAAa;IACzC,OAAO,gBAAgB,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE;QACnC,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QAC3B,OAAO,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9E,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,IAAa;IACvC,OAAO,gBAAgB,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;AAC/D,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAa,EAAE,OAAwC;IAC/E,IAAI,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IAC7D,CAAC;IACD,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC9C,MAAM,GAAG,GAA4B,EAAE,CAAC;QACxC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAChD,GAAG,CAAC,GAAG,CAAC,GAAG,gBAAgB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC9C,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/mapping.d.ts

@@ -0,0 +1,41 @@
+export interface FieldContext {
+    method: string;
+    field: string;
+}
+/** A known value field: exact decimal → bigint sats. */
+export declare function mapAmount(value: unknown, ctx: FieldContext, opts?: {
+    signed?: boolean;
+}): bigint;
+export declare function mapAmountOptional(value: unknown, ctx: FieldContext, opts?: {
+    signed?: boolean;
+}): bigint | undefined;
+/**
+ * A satoshi-INTEGER field (addressindex family emits raw sats, not
+ * decimals) → bigint. Exact at any magnitude.
+ */
+export declare function mapSats(value: unknown, ctx: FieldContext, opts?: {
+    signed?: boolean;
+}): bigint;
+export declare function mapSatsOptional(value: unknown, ctx: FieldContext, opts?: {
+    signed?: boolean;
+}): bigint | undefined;
+/** Heights, counts, indexes, timestamps — plain safe integers. */
+export declare function mapInt(value: unknown, ctx: FieldContext): number;
+export declare function mapIntOptional(value: unknown, ctx: FieldContext): number | undefined;
+/** Non-value floats (e.g. difficulty) — float64 is the honest type here. */
+export declare function mapFloat(value: unknown, ctx: FieldContext): number;
+export declare function mapString(value: unknown, ctx: FieldContext): string;
+export declare function mapStringOptional(value: unknown, ctx: FieldContext): string | undefined;
+export declare function mapBoolean(value: unknown, ctx: FieldContext): boolean;
+export declare function mapBooleanOptional(value: unknown, ctx: FieldContext): boolean | undefined;
+export declare function mapStringArray(value: unknown, ctx: FieldContext): string[];
+/** Assert the raw result is a JSON object and return it for field access. */
+export declare function expectObject(value: unknown, method: string): Record<string, unknown>;
+export declare function expectArray(value: unknown, method: string, field?: string): unknown[];
+/**
+ * Merge unmapped fields into a curated object: every key of `raw` not
+ * already produced by the mapper is passed through with safe-number
+ * conversion. Newer daemons must never break a reader (drift rule).
+ */
+export declare function withPassthrough<T extends Record<string, unknown>>(raw: Record<string, unknown>, curated: T): T;
+//# sourceMappingURL=mapping.d.ts.map

package/dist/mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapping.d.ts","sourceRoot":"","sources":["../src/mapping.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAMD,wDAAwD;AACxD,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,YAAY,EAAE,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAShG;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,YAAY,EACjB,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAC1B,MAAM,GAAG,SAAS,CAEpB;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,YAAY,EAAE,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAa9F;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,YAAY,EAAE,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,GAAG,SAAS,CAElH;AAED,kEAAkE;AAClE,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,YAAY,GAAG,MAAM,CAUhE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS,CAEpF;AAED,4EAA4E;AAC5E,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,YAAY,GAAG,MAAM,CAKlE;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,YAAY,GAAG,MAAM,CAKnE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS,CAEvF;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO,CAKrE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO,GAAG,SAAS,CAEzF;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,YAAY,GAAG,MAAM,EAAE,CAK1E;AAED,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAKpF;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,SAAa,GAAG,OAAO,EAAE,CAKzF;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CAW9G"}

package/dist/mapping.js

@@ -0,0 +1,139 @@
+/**
+ * Response-mapping helpers for curated (T1) methods. Mappers receive the raw
+ * lossless tree from the transport (`LosslessNumber` for every number
+ * literal) and produce the curated shape: value fields as bigint sats,
+ * heights/counts/timestamps as `number`, unknown fields passed through with
+ * safe-number conversion (safe integers → number, everything else → exact
+ * decimal string — no float64 rounding, ever).
+ */
+import { parseAmount } from "./amount.js";
+import { ResponseMappingError } from "./errors.js";
+import { isLosslessNumber, toSafeNumbers } from "./lossless.js";
+function fail(ctx, message) {
+    throw new ResponseMappingError(ctx.method, ctx.field, message);
+}
+/** A known value field: exact decimal → bigint sats. */
+export function mapAmount(value, ctx, opts) {
+    if (!isLosslessNumber(value)) {
+        fail(ctx, `expected a JSON number (amount), got ${describe(value)}`);
+    }
+    try {
+        return parseAmount(value.toString(), opts?.signed === true ? { allowNegative: true } : undefined);
+    }
+    catch (err) {
+        fail(ctx, err instanceof Error ? err.message : String(err));
+    }
+}
+export function mapAmountOptional(value, ctx, opts) {
+    return value === undefined || value === null ? undefined : mapAmount(value, ctx, opts);
+}
+/**
+ * A satoshi-INTEGER field (addressindex family emits raw sats, not
+ * decimals) → bigint. Exact at any magnitude.
+ */
+export function mapSats(value, ctx, opts) {
+    if (!isLosslessNumber(value)) {
+        fail(ctx, `expected a JSON number (integer satoshis), got ${describe(value)}`);
+    }
+    const text = value.toString();
+    if (!/^-?\d+$/.test(text)) {
+        fail(ctx, `expected integer satoshis, got ${text}`);
+    }
+    const sats = BigInt(text);
+    if (sats < 0n && opts?.signed !== true) {
+        fail(ctx, `negative satoshis: ${text}`);
+    }
+    return sats;
+}
+export function mapSatsOptional(value, ctx, opts) {
+    return value === undefined || value === null ? undefined : mapSats(value, ctx, opts);
+}
+/** Heights, counts, indexes, timestamps — plain safe integers. */
+export function mapInt(value, ctx) {
+    if (!isLosslessNumber(value)) {
+        fail(ctx, `expected a JSON number (integer), got ${describe(value)}`);
+    }
+    const text = value.toString();
+    const num = Number(text);
+    if (!Number.isSafeInteger(num) || String(num) !== text) {
+        fail(ctx, `expected a safe integer, got ${text}`);
+    }
+    return num;
+}
+export function mapIntOptional(value, ctx) {
+    return value === undefined || value === null ? undefined : mapInt(value, ctx);
+}
+/** Non-value floats (e.g. difficulty) — float64 is the honest type here. */
+export function mapFloat(value, ctx) {
+    if (!isLosslessNumber(value)) {
+        fail(ctx, `expected a JSON number, got ${describe(value)}`);
+    }
+    return Number(value.toString());
+}
+export function mapString(value, ctx) {
+    if (typeof value !== "string") {
+        fail(ctx, `expected a string, got ${describe(value)}`);
+    }
+    return value;
+}
+export function mapStringOptional(value, ctx) {
+    return value === undefined || value === null ? undefined : mapString(value, ctx);
+}
+export function mapBoolean(value, ctx) {
+    if (typeof value !== "boolean") {
+        fail(ctx, `expected a boolean, got ${describe(value)}`);
+    }
+    return value;
+}
+export function mapBooleanOptional(value, ctx) {
+    return value === undefined || value === null ? undefined : mapBoolean(value, ctx);
+}
+export function mapStringArray(value, ctx) {
+    if (!Array.isArray(value)) {
+        fail(ctx, `expected an array, got ${describe(value)}`);
+    }
+    return value.map((item, i) => mapString(item, { method: ctx.method, field: `${ctx.field}[${i}]` }));
+}
+/** Assert the raw result is a JSON object and return it for field access. */
+export function expectObject(value, method) {
+    if (value === null || typeof value !== "object" || Array.isArray(value) || isLosslessNumber(value)) {
+        throw new ResponseMappingError(method, "(result)", `expected an object, got ${describe(value)}`);
+    }
+    return value;
+}
+export function expectArray(value, method, field = "(result)") {
+    if (!Array.isArray(value)) {
+        throw new ResponseMappingError(method, field, `expected an array, got ${describe(value)}`);
+    }
+    return value;
+}
+/**
+ * Merge unmapped fields into a curated object: every key of `raw` not
+ * already produced by the mapper is passed through with safe-number
+ * conversion. Newer daemons must never break a reader (drift rule).
+ */
+export function withPassthrough(raw, curated) {
+    const out = {};
+    for (const [key, value] of Object.entries(curated)) {
+        if (value !== undefined)
+            out[key] = value; // absent optionals stay absent
+    }
+    for (const [key, value] of Object.entries(raw)) {
+        if (!(key in curated)) {
+            out[key] = toSafeNumbers(value);
+        }
+    }
+    return out;
+}
+function describe(value) {
+    if (value === null)
+        return "null";
+    if (value === undefined)
+        return "undefined";
+    if (isLosslessNumber(value))
+        return `number (${value.toString()})`;
+    if (Array.isArray(value))
+        return "array";
+    return typeof value;
+}
+//# sourceMappingURL=mapping.js.map

package/dist/mapping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapping.js","sourceRoot":"","sources":["../src/mapping.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAOhE,SAAS,IAAI,CAAC,GAAiB,EAAE,OAAe;IAC9C,MAAM,IAAI,oBAAoB,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AACjE,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,SAAS,CAAC,KAAc,EAAE,GAAiB,EAAE,IAA2B;IACtF,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,IAAI,CAAC,GAAG,EAAE,wCAAwC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACvE,CAAC;IACD,IAAI,CAAC;QACH,OAAO,WAAW,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACpG,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,GAAG,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9D,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,KAAc,EACd,GAAiB,EACjB,IAA2B;IAE3B,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;AACzF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,KAAc,EAAE,GAAiB,EAAE,IAA2B;IACpF,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,IAAI,CAAC,GAAG,EAAE,kDAAkD,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACjF,CAAC;IACD,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC9B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1B,IAAI,CAAC,GAAG,EAAE,kCAAkC,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAC1B,IAAI,IAAI,GAAG,EAAE,IAAI,IAAI,EAAE,MAAM,KAAK,IAAI,EAAE,CAAC;QACvC,IAAI,CAAC,GAAG,EAAE,sBAAsB,IAAI,EAAE,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAc,EAAE,GAAiB,EAAE,IAA2B;IAC5F,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;AACvF,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,MAAM,CAAC,KAAc,EAAE,GAAiB;IACtD,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,IAAI,CAAC,GAAG,EAAE,yCAAyC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACxE,CAAC;IACD,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC9B,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IACzB,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;QACvD,IAAI,CAAC,GAAG,EAAE,gCAAgC,IAAI,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAc,EAAE,GAAiB;IAC9D,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAChF,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,QAAQ,CAAC,KAAc,EAAE,GAAiB;IACxD,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,IAAI,CAAC,GAAG,EAAE,+BAA+B,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAc,EAAE,GAAiB;IACzD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,CAAC,GAAG,EAAE,0BAA0B,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAc,EAAE,GAAiB;IACjE,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACnF,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAc,EAAE,GAAiB;IAC1D,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,IAAI,CAAC,GAAG,EAAE,2BAA2B,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAc,EAAE,GAAiB;IAClE,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACpF,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAc,EAAE,GAAiB;IAC9D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,IAAI,CAAC,GAAG,EAAE,0BAA0B,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,CAAC,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;AACtG,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,YAAY,CAAC,KAAc,EAAE,MAAc;IACzD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;QACnG,MAAM,IAAI,oBAAoB,CAAC,MAAM,EAAE,UAAU,EAAE,2BAA2B,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACnG,CAAC;IACD,OAAO,KAAgC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAc,EAAE,MAAc,EAAE,KAAK,GAAG,UAAU;IAC5E,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,oBAAoB,CAAC,MAAM,EAAE,KAAK,EAAE,0BAA0B,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC7F,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAoC,GAA4B,EAAE,OAAU;IACzG,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,IAAI,KAAK,KAAK,SAAS;YAAE,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,+BAA+B;IAC5E,CAAC;IACD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,IAAI,CAAC,CAAC,GAAG,IAAI,OAAO,CAAC,EAAE,CAAC;YACtB,GAAG,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IACD,OAAO,GAAQ,CAAC;AAClB,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IAClC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,WAAW,CAAC;IAC5C,IAAI,gBAAgB,CAAC,KAAK,CAAC;QAAE,OAAO,WAAW,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC;IACnE,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IACzC,OAAO,OAAO,KAAK,CAAC;AACtB,CAAC"}

package/dist/methods/addressindex.d.ts

@@ -0,0 +1,69 @@
+import type { RpcTransport } from "../transport.js";
+/**
+ * Addressindex family (requires `-addressindex=1` on the daemon; the public
+ * gateway exposes it too). Wire quirk, empirically recorded: `balance` /
+ * `received` / `satoshis` are raw satoshi INTEGERS while `currencybalance` /
+ * `currencyreceived` are 8-decimal values — both map to bigint sats here.
+ */
+export interface AddressBalanceResult {
+    /** Native-currency balance — bigint sats (wire: satoshi integer). */
+    balance: bigint;
+    /** Total received — bigint sats (wire: satoshi integer). */
+    received: bigint;
+    /** Per-currency balances — bigint sats (wire: 8-decimal values). */
+    currencybalance?: Record<string, bigint> | undefined;
+    currencyreceived?: Record<string, bigint> | undefined;
+    [key: string]: unknown;
+}
+export interface AddressUtxo {
+    address: string;
+    txid: string;
+    outputIndex: number;
+    script: string;
+    /** Bigint sats (wire: satoshi integer). */
+    satoshis: bigint;
+    height?: number | undefined;
+    [key: string]: unknown;
+}
+export interface AddressDelta {
+    address: string;
+    txid: string;
+    /** Signed — bigint sats (wire: satoshi integer). */
+    satoshis: bigint;
+    index: number;
+    blockindex?: number | undefined;
+    height?: number | undefined;
+    [key: string]: unknown;
+}
+export interface AddressRangeOptions {
+    addresses: string[];
+    /** Start block height. */
+    start?: number;
+    /** End block height. */
+    end?: number;
+}
+export declare function mapAddressBalance(raw: unknown): AddressBalanceResult;
+export declare function mapAddressUtxo(raw: unknown, index: number): AddressUtxo;
+export declare function mapAddressDelta(raw: unknown, method: string, index: number): AddressDelta;
+/** Address index queries (transparent addresses, cross-wallet). */
+export declare class AddressIndexApi {
+    private readonly transport;
+    constructor(transport: RpcTransport);
+    /** Balance/received of arbitrary transparent addresses — bigint sats. */
+    getAddressBalance(options: {
+        addresses: string[];
+    }): Promise<AddressBalanceResult>;
+    /** Unspent outputs of arbitrary transparent addresses — bigint sats. */
+    getAddressUtxos(options: {
+        addresses: string[];
+    }): Promise<AddressUtxo[]>;
+    /** Balance changes per address over a height range — signed bigint sats. */
+    getAddressDeltas(options: AddressRangeOptions): Promise<AddressDelta[]>;
+    /** Mempool deltas touching these addresses — signed bigint sats. */
+    getAddressMempool(options: {
+        addresses: string[];
+    }): Promise<AddressDelta[]>;
+    /** Txids touching these addresses (optionally height-bounded). */
+    getAddressTxids(options: AddressRangeOptions): Promise<string[]>;
+}
+//# sourceMappingURL=addressindex.d.ts.map

package/dist/methods/addressindex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"addressindex.d.ts","sourceRoot":"","sources":["../../src/methods/addressindex.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD;;;;;GAKG;AAEH,MAAM,WAAW,oBAAoB;IACnC,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IACrD,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IACtD,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,0BAA0B;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wBAAwB;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAoBD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,oBAAoB,CASpE;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,CAYvE;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,CAWzF;AAED,mEAAmE;AACnE,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,YAAY;IAEpD,yEAAyE;IACnE,iBAAiB,CAAC,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAIxF,wEAAwE;IAClE,eAAe,CAAC,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAQ/E,4EAA4E;IACtE,gBAAgB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAQ7E,oEAAoE;IAC9D,iBAAiB,CAAC,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAQlF,kEAAkE;IAC5D,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CASvE"}