crypto-aio 0.0.3 → 0.1.0

package/dist/index.d.ts

@@ -1,14 +1,64 @@
-import { Ethereum, EthereumOptions } from './libs';
-export * from './libs';
-export * from './tool';
-export * from './type';
-export interface CryptoAioOptions {
-    [Ethereum.symbol]?: EthereumOptions;
-}
-export declare const cryptoAioOptions: (env?: string) => CryptoAioOptions;
-export declare class CryptoAio {
-    #private;
-    readonly options: CryptoAioOptions;
-    constructor(options?: CryptoAioOptions);
-    get eth(): Ethereum;
-}
+export { Blockchain } from './core/blockchain/handle';
+export type { Balance, NetworkStatus } from './core/blockchain/handle';
+export { CryptoAio } from './core/container/container';
+export type { MonitorApi, OperationsApi, OperationsFilter, } from './core/container/container';
+export { configure, defaultContainer } from './core/container/default';
+export { ERROR_CODES } from './core/errors/codes';
+export type { CodesOf, ErrorCategory, ErrorCode } from './core/errors/codes';
+export { ChainError, ConfigError, CryptoAioError, ProviderError, SigningError, StateError, TimeoutError, UnsupportedCapabilityError, ValidationError, createError, isCryptoAioError, } from './core/errors/error';
+export type { CryptoAioErrorOptions, ErrorContext, ErrorContextValue, SerializedError, } from './core/errors/error';
+export { REDACTED, Secret, isSecret, reveal, secret } from './core/secret/secret';
+export { redactDeep, redactUrl } from './core/secret/redact';
+export { localSigner } from './core/signing/local';
+export type { Curve, GenerateOptions, GeneratedSigner, LocalSignerOptions, MnemonicSignerOptions, } from './core/signing/local';
+export { callbackSigner } from './core/signing/callback';
+export type { CallbackSignerOptions } from './core/signing/callback';
+export { deriveXpubChild } from './core/signing/hd';
+export type { ExtendedKeyVersions } from './core/signing/hd';
+export type { WalletHdOptions } from './core/signing/wallet';
+export type { KeyRef, SignatureBundle, Signer, SignerTicket, SigningContext, SigningParams, SigningPurpose, SigningRequest, SigningResult, } from './core/signing/types';
+export { Address } from './core/model/address';
+export type { AddressFormatter, NormalizedAddress } from './core/model/address';
+export { Amount } from './core/model/amount';
+export type { AmountInput } from './core/model/amount';
+export { assetId, parseAssetId } from './core/model/asset';
+export type { AssetId, AssetInfo, AssetMetadata, AssetRef, TokenRef, } from './core/model/asset';
+export { KNOWN_CAPABILITIES } from './core/model/capability';
+export type { Capability, KnownCapability } from './core/model/capability';
+export { explorerUrl } from './core/model/chain';
+export type { ChainInfo, FinalityPolicy, NativeAssetInfo, NetworkInfo, } from './core/model/chain';
+export { feeTotal } from './core/model/fee';
+export type { FeeBound, FeeCharge, FeeChargeDraft, FeeEstimate, FeeEstimateDraft, FeeOverride, FeeSpeed, } from './core/model/fee';
+export { Library } from './core/model/ids';
+export type { ChainId, ChainRegistry, ExtOf, FamilyOf, FamilyRegistry, KnownLibrary, LibraryOf, NativeClientMap, NetworkOf, } from './core/model/ids';
+export type { DriverIntent, DriverOutput, IntentSummary, StoredIntent, TransferIntent, TransferOutputInput, } from './core/model/intent';
+export { mutuallyExclusive } from './core/model/ordering';
+export type { OrderingData, OrderingKind } from './core/model/ordering';
+export type { AttemptIdKind, AttemptRef, Block, BlockRef, Decoding, Evidence, Finality, RawTx, ResolvedTransfer, SignedTx, Transaction, Transfer, TransferSource, TxState, TxStatus, UnresolvedTransfer, UnsignedTx, } from './core/model/transaction';
+export type { AioOptions, ChainDefaults, HandleConfig, HandleOptions, Hooks, LifecycleOptions, ProviderConfig, ProviderRef, ScopeOptions, WalletConfig, } from './core/config/types';
+export type { TransferOptions } from './core/lifecycle/engine';
+export type { ConfirmationResult, RecoveryReport, TxStatusEvent, WaitOptions, WorkerOptions, } from './core/lifecycle/monitor';
+export type { AttemptView, OperationView, PreparedOperation, Submission, } from './core/lifecycle/views';
+export type { Checkpoint, ScanEvent, ScanEventBody, Scanner, ScannerOptions, } from './core/observe/scanner';
+export type { AdapterManifest, AddressCodec, AddressHistorySource, BlockSource, BroadcastResult, Broadcaster, BuildContext, ChainDriver, ChainReader, DisposableNativeClient, DriverBlock, DriverContext, DriverFactory, DriverLimits, DriverTransaction, DriverTransfer, DriverTxObservation, FinalityLevel, FundsCheck, PeerDependency, ProofSource, ReplacementPolicy, ScanFilter, SequenceSource, TxBuilder, WalletKey, WalletOptions, } from './core/driver/types';
+export type { Plugin } from './core/registry/plugin';
+export type { PresetInput, ProviderPreset } from './core/registry/providers';
+export type { AssetRegistration } from './core/registry/assets';
+export { BUILTIN_SCHEMES } from './core/registry/schemes';
+export type { SignatureScheme, VerifyInput } from './core/registry/schemes';
+export { MemoryCursorStore, MemoryLockManager, MemoryOperationStore, MemorySequenceStore, createMemoryStores, } from './core/store/memory';
+export { CLEARABLE_FIELDS, DATA_CLASSIFICATION, NON_TERMINAL_STATES, OPERATION_PATCH_KEYS, TERMINAL_STATES, isTerminal, } from './core/store/types';
+export type { AttemptObservation, AttemptPurpose, AttemptRecord, ClearableField, CreateResult, CursorStore, DataClass, ExecutionContext, Fence, Lease, LockManager, NewOperation, OperationClaim, OperationFilter, OperationPatch, OperationRecord, OperationState, OperationStore, ScanCursor, SequenceState, SequenceStore, StoredCursor, Stores, } from './core/store/types';
+export { parseTagged, stringifyTagged } from './core/util/json';
+export { PLACEHOLDER_ORIGIN } from './core/transport/types';
+export type { CallOptions, EndpointCall, EndpointConfig, EndpointState, EndpointStatus, HealthProbes, HttpRequest, RequestPurpose, RetryClass, Transport, TransportOptions, } from './core/transport/types';
+export type { AioEvent, AioEventName, AioEvents } from './core/events/types';
+export { createLogger, noopLogger } from './core/events/logger';
+export type { LogFields, LogLevel, LogWriter, Logger } from './core/events/logger';
+export type { Clock } from './core/util/clock';
+export type { EvmExt, EvmFeeDetails, EvmFeeOverride } from './adapters/evm/types';
+export type { TronExpiryOrdering, TronExt, TronFeeDetails, TronFeeOverride, TronResources, } from './adapters/tron/types';
+export type { UtxoAddressType, UtxoExt, UtxoFeeDetails, UtxoFeeOverride, UtxoOutputType, UtxoSelectionPreview, UtxoSelectionRequest, UtxoUnspent, UtxoWalletOptions, } from './adapters/utxo/types';
+export type { SolanaExpiryOrdering, SolanaExt, SolanaFeeDetails, SolanaFeeOverride, SolanaTokenAccount, } from './adapters/solana/types';
+export type { TonExt, TonFeeDetails, TonFeeOverride, TonSeqnoOrdering, TonWalletIdentity, TonWalletVersion, } from './adapters/ton/types';
+export type { AvalancheExt, AvalancheFeeDetails, AvalancheFeeOverride, AvalancheUnspent, AvalancheVm, } from './adapters/avalanche/types';

package/dist/index.js

@@ -1,52 +1,108 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
-    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
-};
-var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
-    if (kind === "m") throw new TypeError("Private method is not writable");
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
-    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
-};
-var _CryptoAio_eth;
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CryptoAio = exports.cryptoAioOptions = void 0;
-const libs_1 = require("./libs");
-const tool_1 = require("./tool");
-__exportStar(require("./libs"), exports);
-__exportStar(require("./tool"), exports);
-__exportStar(require("./type"), exports);
-const cryptoAioOptions = (env) => {
-    return {
-        ETH: (0, tool_1.ethereumOptions)(env),
-    };
-};
-exports.cryptoAioOptions = cryptoAioOptions;
-class CryptoAio {
-    constructor(options = (0, exports.cryptoAioOptions)()) {
-        this.options = options;
-        _CryptoAio_eth.set(this, void 0);
-    }
-    get eth() {
-        return (__classPrivateFieldSet(this, _CryptoAio_eth, __classPrivateFieldGet(this, _CryptoAio_eth, "f") || new libs_1.Ethereum(this.options['ETH']), "f"));
-    }
-}
-exports.CryptoAio = CryptoAio;
-_CryptoAio_eth = new WeakMap();
+exports.PLACEHOLDER_ORIGIN = exports.stringifyTagged = exports.parseTagged = exports.isTerminal = exports.TERMINAL_STATES = exports.OPERATION_PATCH_KEYS = exports.NON_TERMINAL_STATES = exports.DATA_CLASSIFICATION = exports.CLEARABLE_FIELDS = exports.createMemoryStores = exports.MemorySequenceStore = exports.MemoryOperationStore = exports.MemoryLockManager = exports.MemoryCursorStore = exports.BUILTIN_SCHEMES = exports.mutuallyExclusive = exports.Library = exports.feeTotal = exports.explorerUrl = exports.KNOWN_CAPABILITIES = exports.parseAssetId = exports.assetId = exports.Amount = exports.Address = exports.deriveXpubChild = exports.callbackSigner = exports.localSigner = exports.redactUrl = exports.redactDeep = exports.secret = exports.reveal = exports.isSecret = exports.Secret = exports.REDACTED = exports.isCryptoAioError = exports.createError = exports.ValidationError = exports.UnsupportedCapabilityError = exports.TimeoutError = exports.StateError = exports.SigningError = exports.ProviderError = exports.CryptoAioError = exports.ConfigError = exports.ChainError = exports.ERROR_CODES = exports.defaultContainer = exports.configure = exports.CryptoAio = exports.Blockchain = void 0;
+exports.noopLogger = exports.createLogger = void 0;
+/**
+ * `crypto-aio`: the container (`CryptoAio`), the handle (`Blockchain`), the domain model,
+ * errors, signers, stores and the extension points for chain family plugins.
+ *
+ * @module crypto-aio
+ */
+const plugin_1 = require("./adapters/avalanche/plugin");
+const plugin_2 = require("./adapters/evm/plugin");
+const plugin_3 = require("./adapters/solana/plugin");
+const plugin_4 = require("./adapters/ton/plugin");
+const plugin_5 = require("./adapters/tron/plugin");
+const plugin_6 = require("./adapters/utxo/plugin");
+const builtins_1 = require("./core/container/builtins");
+/** Built-in chain family plugins. Each family plugin module is SDK-free; drivers load lazily. */
+const BUILTIN_PLUGINS = [
+    (0, plugin_2.evmPlugin)(),
+    (0, plugin_6.utxoPlugin)(),
+    (0, plugin_5.tronPlugin)(),
+    (0, plugin_3.solanaPlugin)(),
+    (0, plugin_4.tonPlugin)(),
+    (0, plugin_1.avalanchePlugin)(),
+];
+(0, builtins_1.setBuiltinPlugins)(BUILTIN_PLUGINS);
+// Entry points
+var handle_1 = require("./core/blockchain/handle");
+Object.defineProperty(exports, "Blockchain", { enumerable: true, get: function () { return handle_1.Blockchain; } });
+var container_1 = require("./core/container/container");
+Object.defineProperty(exports, "CryptoAio", { enumerable: true, get: function () { return container_1.CryptoAio; } });
+var default_1 = require("./core/container/default");
+Object.defineProperty(exports, "configure", { enumerable: true, get: function () { return default_1.configure; } });
+Object.defineProperty(exports, "defaultContainer", { enumerable: true, get: function () { return default_1.defaultContainer; } });
+// Errors
+var codes_1 = require("./core/errors/codes");
+Object.defineProperty(exports, "ERROR_CODES", { enumerable: true, get: function () { return codes_1.ERROR_CODES; } });
+var error_1 = require("./core/errors/error");
+Object.defineProperty(exports, "ChainError", { enumerable: true, get: function () { return error_1.ChainError; } });
+Object.defineProperty(exports, "ConfigError", { enumerable: true, get: function () { return error_1.ConfigError; } });
+Object.defineProperty(exports, "CryptoAioError", { enumerable: true, get: function () { return error_1.CryptoAioError; } });
+Object.defineProperty(exports, "ProviderError", { enumerable: true, get: function () { return error_1.ProviderError; } });
+Object.defineProperty(exports, "SigningError", { enumerable: true, get: function () { return error_1.SigningError; } });
+Object.defineProperty(exports, "StateError", { enumerable: true, get: function () { return error_1.StateError; } });
+Object.defineProperty(exports, "TimeoutError", { enumerable: true, get: function () { return error_1.TimeoutError; } });
+Object.defineProperty(exports, "UnsupportedCapabilityError", { enumerable: true, get: function () { return error_1.UnsupportedCapabilityError; } });
+Object.defineProperty(exports, "ValidationError", { enumerable: true, get: function () { return error_1.ValidationError; } });
+Object.defineProperty(exports, "createError", { enumerable: true, get: function () { return error_1.createError; } });
+Object.defineProperty(exports, "isCryptoAioError", { enumerable: true, get: function () { return error_1.isCryptoAioError; } });
+// Secrets and signing
+var secret_1 = require("./core/secret/secret");
+Object.defineProperty(exports, "REDACTED", { enumerable: true, get: function () { return secret_1.REDACTED; } });
+Object.defineProperty(exports, "Secret", { enumerable: true, get: function () { return secret_1.Secret; } });
+Object.defineProperty(exports, "isSecret", { enumerable: true, get: function () { return secret_1.isSecret; } });
+Object.defineProperty(exports, "reveal", { enumerable: true, get: function () { return secret_1.reveal; } });
+Object.defineProperty(exports, "secret", { enumerable: true, get: function () { return secret_1.secret; } });
+var redact_1 = require("./core/secret/redact");
+Object.defineProperty(exports, "redactDeep", { enumerable: true, get: function () { return redact_1.redactDeep; } });
+Object.defineProperty(exports, "redactUrl", { enumerable: true, get: function () { return redact_1.redactUrl; } });
+var local_1 = require("./core/signing/local");
+Object.defineProperty(exports, "localSigner", { enumerable: true, get: function () { return local_1.localSigner; } });
+var callback_1 = require("./core/signing/callback");
+Object.defineProperty(exports, "callbackSigner", { enumerable: true, get: function () { return callback_1.callbackSigner; } });
+var hd_1 = require("./core/signing/hd");
+Object.defineProperty(exports, "deriveXpubChild", { enumerable: true, get: function () { return hd_1.deriveXpubChild; } });
+// Domain model
+var address_1 = require("./core/model/address");
+Object.defineProperty(exports, "Address", { enumerable: true, get: function () { return address_1.Address; } });
+var amount_1 = require("./core/model/amount");
+Object.defineProperty(exports, "Amount", { enumerable: true, get: function () { return amount_1.Amount; } });
+var asset_1 = require("./core/model/asset");
+Object.defineProperty(exports, "assetId", { enumerable: true, get: function () { return asset_1.assetId; } });
+Object.defineProperty(exports, "parseAssetId", { enumerable: true, get: function () { return asset_1.parseAssetId; } });
+var capability_1 = require("./core/model/capability");
+Object.defineProperty(exports, "KNOWN_CAPABILITIES", { enumerable: true, get: function () { return capability_1.KNOWN_CAPABILITIES; } });
+var chain_1 = require("./core/model/chain");
+Object.defineProperty(exports, "explorerUrl", { enumerable: true, get: function () { return chain_1.explorerUrl; } });
+var fee_1 = require("./core/model/fee");
+Object.defineProperty(exports, "feeTotal", { enumerable: true, get: function () { return fee_1.feeTotal; } });
+var ids_1 = require("./core/model/ids");
+Object.defineProperty(exports, "Library", { enumerable: true, get: function () { return ids_1.Library; } });
+var ordering_1 = require("./core/model/ordering");
+Object.defineProperty(exports, "mutuallyExclusive", { enumerable: true, get: function () { return ordering_1.mutuallyExclusive; } });
+var schemes_1 = require("./core/registry/schemes");
+Object.defineProperty(exports, "BUILTIN_SCHEMES", { enumerable: true, get: function () { return schemes_1.BUILTIN_SCHEMES; } });
+var memory_1 = require("./core/store/memory");
+Object.defineProperty(exports, "MemoryCursorStore", { enumerable: true, get: function () { return memory_1.MemoryCursorStore; } });
+Object.defineProperty(exports, "MemoryLockManager", { enumerable: true, get: function () { return memory_1.MemoryLockManager; } });
+Object.defineProperty(exports, "MemoryOperationStore", { enumerable: true, get: function () { return memory_1.MemoryOperationStore; } });
+Object.defineProperty(exports, "MemorySequenceStore", { enumerable: true, get: function () { return memory_1.MemorySequenceStore; } });
+Object.defineProperty(exports, "createMemoryStores", { enumerable: true, get: function () { return memory_1.createMemoryStores; } });
+var types_1 = require("./core/store/types");
+Object.defineProperty(exports, "CLEARABLE_FIELDS", { enumerable: true, get: function () { return types_1.CLEARABLE_FIELDS; } });
+Object.defineProperty(exports, "DATA_CLASSIFICATION", { enumerable: true, get: function () { return types_1.DATA_CLASSIFICATION; } });
+Object.defineProperty(exports, "NON_TERMINAL_STATES", { enumerable: true, get: function () { return types_1.NON_TERMINAL_STATES; } });
+Object.defineProperty(exports, "OPERATION_PATCH_KEYS", { enumerable: true, get: function () { return types_1.OPERATION_PATCH_KEYS; } });
+Object.defineProperty(exports, "TERMINAL_STATES", { enumerable: true, get: function () { return types_1.TERMINAL_STATES; } });
+Object.defineProperty(exports, "isTerminal", { enumerable: true, get: function () { return types_1.isTerminal; } });
+var json_1 = require("./core/util/json");
+Object.defineProperty(exports, "parseTagged", { enumerable: true, get: function () { return json_1.parseTagged; } });
+Object.defineProperty(exports, "stringifyTagged", { enumerable: true, get: function () { return json_1.stringifyTagged; } });
+var types_2 = require("./core/transport/types");
+Object.defineProperty(exports, "PLACEHOLDER_ORIGIN", { enumerable: true, get: function () { return types_2.PLACEHOLDER_ORIGIN; } });
+var logger_1 = require("./core/events/logger");
+Object.defineProperty(exports, "createLogger", { enumerable: true, get: function () { return logger_1.createLogger; } });
+Object.defineProperty(exports, "noopLogger", { enumerable: true, get: function () { return logger_1.noopLogger; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,iCAAmD;AACnD,iCAAyC;AAEzC,yCAAuB;AACvB,yCAAuB;AACvB,yCAAuB;AAMhB,MAAM,gBAAgB,GAAG,CAAC,GAAY,EAAoB,EAAE;IACjE,OAAO;QACL,GAAG,EAAE,IAAA,sBAAe,EAAC,GAAG,CAAC;KAC1B,CAAC;AACJ,CAAC,CAAC;AAJW,QAAA,gBAAgB,oBAI3B;AAEF,MAAa,SAAS;IAGpB,YAAqB,UAA4B,IAAA,wBAAgB,GAAE;QAA9C,YAAO,GAAP,OAAO,CAAuC;QAFnE,iCAAgB;IAEsD,CAAC;IAEvE,IAAI,GAAG;QACL,OAAO,CAAC,uBAAA,IAAI,kBAAQ,uBAAA,IAAI,sBAAK,IAAI,IAAI,eAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAA,CAAC,CAAC;IACtE,CAAC;CACF;AARD,8BAQC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;AAAA;;;;;GAKG;AACH,wDAA8D;AAC9D,kDAAkD;AAClD,qDAAwD;AACxD,kDAAkD;AAClD,mDAAoD;AACpD,mDAAoD;AACpD,wDAA8D;AAG9D,iGAAiG;AACjG,MAAM,eAAe,GAAsB;IACzC,IAAA,kBAAS,GAAE;IACX,IAAA,mBAAU,GAAE;IACZ,IAAA,mBAAU,GAAE;IACZ,IAAA,qBAAY,GAAE;IACd,IAAA,kBAAS,GAAE;IACX,IAAA,wBAAe,GAAE;CAClB,CAAC;AACF,IAAA,4BAAiB,EAAC,eAAe,CAAC,CAAC;AAEnC,eAAe;AACf,mDAAsD;AAA7C,oGAAA,UAAU,OAAA;AAEnB,wDAAuD;AAA9C,sGAAA,SAAS,OAAA;AAMlB,oDAAuE;AAA9D,oGAAA,SAAS,OAAA;AAAE,2GAAA,gBAAgB,OAAA;AAEpC,SAAS;AACT,6CAAkD;AAAzC,oGAAA,WAAW,OAAA;AAEpB,6CAY6B;AAX3B,mGAAA,UAAU,OAAA;AACV,oGAAA,WAAW,OAAA;AACX,uGAAA,cAAc,OAAA;AACd,sGAAA,aAAa,OAAA;AACb,qGAAA,YAAY,OAAA;AACZ,mGAAA,UAAU,OAAA;AACV,qGAAA,YAAY,OAAA;AACZ,mHAAA,0BAA0B,OAAA;AAC1B,wGAAA,eAAe,OAAA;AACf,oGAAA,WAAW,OAAA;AACX,yGAAA,gBAAgB,OAAA;AASlB,sBAAsB;AACtB,+CAAkF;AAAzE,kGAAA,QAAQ,OAAA;AAAE,gGAAA,MAAM,OAAA;AAAE,kGAAA,QAAQ,OAAA;AAAE,gGAAA,MAAM,OAAA;AAAE,gGAAA,MAAM,OAAA;AACnD,+CAA6D;AAApD,oGAAA,UAAU,OAAA;AAAE,mGAAA,SAAS,OAAA;AAC9B,8CAAmD;AAA1C,oGAAA,WAAW,OAAA;AAQpB,oDAAyD;AAAhD,0GAAA,cAAc,OAAA;AAEvB,wCAAoD;AAA3C,qGAAA,eAAe,OAAA;AAexB,eAAe;AACf,gDAA+C;AAAtC,kGAAA,OAAO,OAAA;AAEhB,8CAA6C;AAApC,gGAAA,MAAM,OAAA;AAEf,4CAA2D;AAAlD,gGAAA,OAAO,OAAA;AAAE,qGAAA,YAAY,OAAA;AAQ9B,sDAA6D;AAApD,gHAAA,kBAAkB,OAAA;AAE3B,4CAAiD;AAAxC,oGAAA,WAAW,OAAA;AAOpB,wCAA4C;AAAnC,+FAAA,QAAQ,OAAA;AAUjB,wCAA2C;AAAlC,8FAAA,OAAO,OAAA;AAoBhB,kDAA0D;AAAjD,6GAAA,iBAAiB,OAAA;AA6F1B,mDAA0D;AAAjD,0GAAA,eAAe,OAAA;AAExB,8CAM6B;AAL3B,2GAAA,iBAAiB,OAAA;AACjB,2GAAA,iBAAiB,OAAA;AACjB,8GAAA,oBAAoB,OAAA;AACpB,6GAAA,mBAAmB,OAAA;AACnB,4GAAA,kBAAkB,OAAA;AAEpB,4CAO4B;AAN1B,yGAAA,gBAAgB,OAAA;AAChB,4GAAA,mBAAmB,OAAA;AACnB,4GAAA,mBAAmB,OAAA;AACnB,6GAAA,oBAAoB,OAAA;AACpB,wGAAA,eAAe,OAAA;AACf,mGAAA,UAAU,OAAA;AA2BZ,yCAAgE;AAAvD,mGAAA,WAAW,OAAA;AAAE,uGAAA,eAAe,OAAA;AACrC,gDAA4D;AAAnD,2GAAA,kBAAkB,OAAA;AAe3B,+CAAgE;AAAvD,sGAAA,YAAY,OAAA;AAAE,oGAAA,UAAU,OAAA","sourcesContent":["/**\n * `crypto-aio`: the container (`CryptoAio`), the handle (`Blockchain`), the domain model,\n * errors, signers, stores and the extension points for chain family plugins.\n *\n * @module crypto-aio\n */\nimport { avalanchePlugin } from './adapters/avalanche/plugin';\nimport { evmPlugin } from './adapters/evm/plugin';\nimport { solanaPlugin } from './adapters/solana/plugin';\nimport { tonPlugin } from './adapters/ton/plugin';\nimport { tronPlugin } from './adapters/tron/plugin';\nimport { utxoPlugin } from './adapters/utxo/plugin';\nimport { setBuiltinPlugins } from './core/container/builtins';\nimport type { Plugin } from './core/registry/plugin';\n\n/** Built-in chain family plugins. Each family plugin module is SDK-free; drivers load lazily. */\nconst BUILTIN_PLUGINS: readonly Plugin[] = [\n  evmPlugin(),\n  utxoPlugin(),\n  tronPlugin(),\n  solanaPlugin(),\n  tonPlugin(),\n  avalanchePlugin(),\n];\nsetBuiltinPlugins(BUILTIN_PLUGINS);\n\n// Entry points\nexport { Blockchain } from './core/blockchain/handle';\nexport type { Balance, NetworkStatus } from './core/blockchain/handle';\nexport { CryptoAio } from './core/container/container';\nexport type {\n  MonitorApi,\n  OperationsApi,\n  OperationsFilter,\n} from './core/container/container';\nexport { configure, defaultContainer } from './core/container/default';\n\n// Errors\nexport { ERROR_CODES } from './core/errors/codes';\nexport type { CodesOf, ErrorCategory, ErrorCode } from './core/errors/codes';\nexport {\n  ChainError,\n  ConfigError,\n  CryptoAioError,\n  ProviderError,\n  SigningError,\n  StateError,\n  TimeoutError,\n  UnsupportedCapabilityError,\n  ValidationError,\n  createError,\n  isCryptoAioError,\n} from './core/errors/error';\nexport type {\n  CryptoAioErrorOptions,\n  ErrorContext,\n  ErrorContextValue,\n  SerializedError,\n} from './core/errors/error';\n\n// Secrets and signing\nexport { REDACTED, Secret, isSecret, reveal, secret } from './core/secret/secret';\nexport { redactDeep, redactUrl } from './core/secret/redact';\nexport { localSigner } from './core/signing/local';\nexport type {\n  Curve,\n  GenerateOptions,\n  GeneratedSigner,\n  LocalSignerOptions,\n  MnemonicSignerOptions,\n} from './core/signing/local';\nexport { callbackSigner } from './core/signing/callback';\nexport type { CallbackSignerOptions } from './core/signing/callback';\nexport { deriveXpubChild } from './core/signing/hd';\nexport type { ExtendedKeyVersions } from './core/signing/hd';\nexport type { WalletHdOptions } from './core/signing/wallet';\nexport type {\n  KeyRef,\n  SignatureBundle,\n  Signer,\n  SignerTicket,\n  SigningContext,\n  SigningParams,\n  SigningPurpose,\n  SigningRequest,\n  SigningResult,\n} from './core/signing/types';\n\n// Domain model\nexport { Address } from './core/model/address';\nexport type { AddressFormatter, NormalizedAddress } from './core/model/address';\nexport { Amount } from './core/model/amount';\nexport type { AmountInput } from './core/model/amount';\nexport { assetId, parseAssetId } from './core/model/asset';\nexport type {\n  AssetId,\n  AssetInfo,\n  AssetMetadata,\n  AssetRef,\n  TokenRef,\n} from './core/model/asset';\nexport { KNOWN_CAPABILITIES } from './core/model/capability';\nexport type { Capability, KnownCapability } from './core/model/capability';\nexport { explorerUrl } from './core/model/chain';\nexport type {\n  ChainInfo,\n  FinalityPolicy,\n  NativeAssetInfo,\n  NetworkInfo,\n} from './core/model/chain';\nexport { feeTotal } from './core/model/fee';\nexport type {\n  FeeBound,\n  FeeCharge,\n  FeeChargeDraft,\n  FeeEstimate,\n  FeeEstimateDraft,\n  FeeOverride,\n  FeeSpeed,\n} from './core/model/fee';\nexport { Library } from './core/model/ids';\nexport type {\n  ChainId,\n  ChainRegistry,\n  ExtOf,\n  FamilyOf,\n  FamilyRegistry,\n  KnownLibrary,\n  LibraryOf,\n  NativeClientMap,\n  NetworkOf,\n} from './core/model/ids';\nexport type {\n  DriverIntent,\n  DriverOutput,\n  IntentSummary,\n  StoredIntent,\n  TransferIntent,\n  TransferOutputInput,\n} from './core/model/intent';\nexport { mutuallyExclusive } from './core/model/ordering';\nexport type { OrderingData, OrderingKind } from './core/model/ordering';\nexport type {\n  AttemptIdKind,\n  AttemptRef,\n  Block,\n  BlockRef,\n  Decoding,\n  Evidence,\n  Finality,\n  RawTx,\n  ResolvedTransfer,\n  SignedTx,\n  Transaction,\n  Transfer,\n  TransferSource,\n  TxState,\n  TxStatus,\n  UnresolvedTransfer,\n  UnsignedTx,\n} from './core/model/transaction';\n\n// Configuration\nexport type {\n  AioOptions,\n  ChainDefaults,\n  HandleConfig,\n  HandleOptions,\n  Hooks,\n  LifecycleOptions,\n  ProviderConfig,\n  ProviderRef,\n  ScopeOptions,\n  WalletConfig,\n} from './core/config/types';\n\n// Lifecycle and observation\nexport type { TransferOptions } from './core/lifecycle/engine';\nexport type {\n  ConfirmationResult,\n  RecoveryReport,\n  TxStatusEvent,\n  WaitOptions,\n  WorkerOptions,\n} from './core/lifecycle/monitor';\nexport type {\n  AttemptView,\n  OperationView,\n  PreparedOperation,\n  Submission,\n} from './core/lifecycle/views';\n// Type only; scanners come from `bc.scanner()`.\nexport type {\n  Checkpoint,\n  ScanEvent,\n  ScanEventBody,\n  Scanner,\n  ScannerOptions,\n} from './core/observe/scanner';\n\n// Extension points: drivers, plugins, presets, schemes, stores, transport, events\nexport type {\n  AdapterManifest,\n  AddressCodec,\n  AddressHistorySource,\n  BlockSource,\n  BroadcastResult,\n  Broadcaster,\n  BuildContext,\n  ChainDriver,\n  ChainReader,\n  DisposableNativeClient,\n  DriverBlock,\n  DriverContext,\n  DriverFactory,\n  DriverLimits,\n  DriverTransaction,\n  DriverTransfer,\n  DriverTxObservation,\n  FinalityLevel,\n  FundsCheck,\n  PeerDependency,\n  ProofSource,\n  ReplacementPolicy,\n  ScanFilter,\n  SequenceSource,\n  TxBuilder,\n  WalletKey,\n  WalletOptions,\n} from './core/driver/types';\nexport type { Plugin } from './core/registry/plugin';\nexport type { PresetInput, ProviderPreset } from './core/registry/providers';\nexport type { AssetRegistration } from './core/registry/assets';\nexport { BUILTIN_SCHEMES } from './core/registry/schemes';\nexport type { SignatureScheme, VerifyInput } from './core/registry/schemes';\nexport {\n  MemoryCursorStore,\n  MemoryLockManager,\n  MemoryOperationStore,\n  MemorySequenceStore,\n  createMemoryStores,\n} from './core/store/memory';\nexport {\n  CLEARABLE_FIELDS,\n  DATA_CLASSIFICATION,\n  NON_TERMINAL_STATES,\n  OPERATION_PATCH_KEYS,\n  TERMINAL_STATES,\n  isTerminal,\n} from './core/store/types';\nexport type {\n  AttemptObservation,\n  AttemptPurpose,\n  AttemptRecord,\n  ClearableField,\n  CreateResult,\n  CursorStore,\n  DataClass,\n  ExecutionContext,\n  Fence,\n  Lease,\n  LockManager,\n  NewOperation,\n  OperationClaim,\n  OperationFilter,\n  OperationPatch,\n  OperationRecord,\n  OperationState,\n  OperationStore,\n  ScanCursor,\n  SequenceState,\n  SequenceStore,\n  StoredCursor,\n  Stores,\n} from './core/store/types';\nexport { parseTagged, stringifyTagged } from './core/util/json';\nexport { PLACEHOLDER_ORIGIN } from './core/transport/types';\nexport type {\n  CallOptions,\n  EndpointCall,\n  EndpointConfig,\n  EndpointState,\n  EndpointStatus,\n  HealthProbes,\n  HttpRequest,\n  RequestPurpose,\n  RetryClass,\n  Transport,\n  TransportOptions,\n} from './core/transport/types';\nexport type { AioEvent, AioEventName, AioEvents } from './core/events/types';\nexport { createLogger, noopLogger } from './core/events/logger';\nexport type { LogFields, LogLevel, LogWriter, Logger } from './core/events/logger';\nexport type { Clock } from './core/util/clock';\n\n// Chain families: SDK-free types. SDK client types are in `crypto-aio/avalanche`,\n// `crypto-aio/evm`, `crypto-aio/solana`, `crypto-aio/ton`, `crypto-aio/tron` and\n// `crypto-aio/utxo`.\nexport type { EvmExt, EvmFeeDetails, EvmFeeOverride } from './adapters/evm/types';\nexport type {\n  TronExpiryOrdering,\n  TronExt,\n  TronFeeDetails,\n  TronFeeOverride,\n  TronResources,\n} from './adapters/tron/types';\nexport type {\n  UtxoAddressType,\n  UtxoExt,\n  UtxoFeeDetails,\n  UtxoFeeOverride,\n  UtxoOutputType,\n  UtxoSelectionPreview,\n  UtxoSelectionRequest,\n  UtxoUnspent,\n  UtxoWalletOptions,\n} from './adapters/utxo/types';\nexport type {\n  SolanaExpiryOrdering,\n  SolanaExt,\n  SolanaFeeDetails,\n  SolanaFeeOverride,\n  SolanaTokenAccount,\n} from './adapters/solana/types';\nexport type {\n  TonExt,\n  TonFeeDetails,\n  TonFeeOverride,\n  TonSeqnoOrdering,\n  TonWalletIdentity,\n  TonWalletVersion,\n} from './adapters/ton/types';\nexport type {\n  AvalancheExt,\n  AvalancheFeeDetails,\n  AvalancheFeeOverride,\n  AvalancheUnspent,\n  AvalancheVm,\n} from './adapters/avalanche/types';\n"]}

package/dist/native.d.ts

@@ -0,0 +1,21 @@
+/**
+ * `crypto-aio/native`: the escape hatch to a handle's own SDK client, outside the semver
+ * guarantees of crypto-aio.
+ *
+ * @module crypto-aio/native
+ */
+import type { Blockchain } from './core/blockchain/handle';
+import type { ChainId, NativeClientMap } from './core/model/ids';
+/**
+ * Escape hatch to the underlying SDK client. OUTSIDE the semver guarantees of crypto-aio.
+ *
+ * The client belongs to this handle only: the driver builds it for the handle on the first
+ * call, and later calls on the same handle return that same client. It is never the pooled
+ * instance the drivers use, so mutating it cannot affect other handles or tenants, and it is
+ * reachable only through this function (not through the handle, `JSON` or `inspect`). The
+ * library name must match the handle's (`INCOMPATIBLE_SELECTION` otherwise).
+ *
+ * The root container's `close()` releases every client handed out here; after it,
+ * `native()` fails with `INVALID_TRANSITION`, as the handle's own methods do.
+ */
+export declare function native<L extends Extract<keyof NativeClientMap, string>, C extends ChainId = ChainId>(handle: Blockchain<C>, library: L): Promise<NativeClientMap[L]>;

package/dist/native.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.native = native;
+const internal_1 = require("./core/blockchain/internal");
+const error_1 = require("./core/errors/error");
+/**
+ * Escape hatch to the underlying SDK client. OUTSIDE the semver guarantees of crypto-aio.
+ *
+ * The client belongs to this handle only: the driver builds it for the handle on the first
+ * call, and later calls on the same handle return that same client. It is never the pooled
+ * instance the drivers use, so mutating it cannot affect other handles or tenants, and it is
+ * reachable only through this function (not through the handle, `JSON` or `inspect`). The
+ * library name must match the handle's (`INCOMPATIBLE_SELECTION` otherwise).
+ *
+ * The root container's `close()` releases every client handed out here; after it,
+ * `native()` fails with `INVALID_TRANSITION`, as the handle's own methods do.
+ */
+async function native(handle, library) {
+    const internals = (0, internal_1.internalsOf)(handle);
+    internals.assertOpen();
+    if (internals.selection.library !== library) {
+        throw new error_1.ConfigError('INCOMPATIBLE_SELECTION', 
+        // The caller's text (perhaps a pasted secret) is never repeated; the handle's own
+        // library is named.
+        `this handle's library is '${internals.selection.library}'; ask native() for that one`);
+    }
+    const cached = internals.nativeClients.get(library);
+    if (cached !== undefined)
+        return cached;
+    const { driver } = await internals.pooled();
+    internals.assertOpen(); // the root may have closed while this call awaited the driver
+    // A concurrent call may have built the client while this one awaited the driver.
+    const built = internals.nativeClients.get(library);
+    if (built !== undefined)
+        return built;
+    if (!driver.createNativeClient) {
+        throw new error_1.UnsupportedCapabilityError('UNSUPPORTED_CAPABILITY', `library '${library}' exposes no native client`);
+    }
+    const created = driver.createNativeClient();
+    internals.registerNative(created);
+    internals.nativeClients.set(library, created.client);
+    return created.client;
+}
+//# sourceMappingURL=native.js.map

package/dist/native.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.js","sourceRoot":"","sources":["../src/native.ts"],"names":[],"mappings":";;AAuBA,wBA+BC;AA/CD,yDAAyD;AACzD,+CAA8E;AAG9E;;;;;;;;;;;GAWG;AACI,KAAK,UAAU,MAAM,CAG1B,MAAqB,EAAE,OAAU;IACjC,MAAM,SAAS,GAAG,IAAA,sBAAW,EAAC,MAAM,CAAC,CAAC;IACtC,SAAS,CAAC,UAAU,EAAE,CAAC;IACvB,IAAI,SAAS,CAAC,SAAS,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;QAC5C,MAAM,IAAI,mBAAW,CACnB,wBAAwB;QACxB,kFAAkF;QAClF,oBAAoB;QACpB,6BAA6B,SAAS,CAAC,SAAS,CAAC,OAAO,8BAA8B,CACvF,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,SAAS,CAAC,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACpD,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,MAA4B,CAAC;IAC9D,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE,CAAC;IAC5C,SAAS,CAAC,UAAU,EAAE,CAAC,CAAC,8DAA8D;IACtF,iFAAiF;IACjF,MAAM,KAAK,GAAG,SAAS,CAAC,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACnD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAA2B,CAAC;IAC5D,IAAI,CAAC,MAAM,CAAC,kBAAkB,EAAE,CAAC;QAC/B,MAAM,IAAI,kCAA0B,CAClC,wBAAwB,EACxB,YAAY,OAAO,4BAA4B,CAChD,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,kBAAkB,EAAE,CAAC;IAC5C,SAAS,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IAClC,SAAS,CAAC,aAAa,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,OAAO,OAAO,CAAC,MAA4B,CAAC;AAC9C,CAAC","sourcesContent":["/**\n * `crypto-aio/native`: the escape hatch to a handle's own SDK client, outside the semver\n * guarantees of crypto-aio.\n *\n * @module crypto-aio/native\n */\nimport type { Blockchain } from './core/blockchain/handle';\nimport { internalsOf } from './core/blockchain/internal';\nimport { ConfigError, UnsupportedCapabilityError } from './core/errors/error';\nimport type { ChainId, NativeClientMap } from './core/model/ids';\n\n/**\n * Escape hatch to the underlying SDK client. OUTSIDE the semver guarantees of crypto-aio.\n *\n * The client belongs to this handle only: the driver builds it for the handle on the first\n * call, and later calls on the same handle return that same client. It is never the pooled\n * instance the drivers use, so mutating it cannot affect other handles or tenants, and it is\n * reachable only through this function (not through the handle, `JSON` or `inspect`). The\n * library name must match the handle's (`INCOMPATIBLE_SELECTION` otherwise).\n *\n * The root container's `close()` releases every client handed out here; after it,\n * `native()` fails with `INVALID_TRANSITION`, as the handle's own methods do.\n */\nexport async function native<\n  L extends Extract<keyof NativeClientMap, string>,\n  C extends ChainId = ChainId,\n>(handle: Blockchain<C>, library: L): Promise<NativeClientMap[L]> {\n  const internals = internalsOf(handle);\n  internals.assertOpen();\n  if (internals.selection.library !== library) {\n    throw new ConfigError(\n      'INCOMPATIBLE_SELECTION',\n      // The caller's text (perhaps a pasted secret) is never repeated; the handle's own\n      // library is named.\n      `this handle's library is '${internals.selection.library}'; ask native() for that one`,\n    );\n  }\n  const cached = internals.nativeClients.get(library);\n  if (cached !== undefined) return cached as NativeClientMap[L];\n  const { driver } = await internals.pooled();\n  internals.assertOpen(); // the root may have closed while this call awaited the driver\n  // A concurrent call may have built the client while this one awaited the driver.\n  const built = internals.nativeClients.get(library);\n  if (built !== undefined) return built as NativeClientMap[L];\n  if (!driver.createNativeClient) {\n    throw new UnsupportedCapabilityError(\n      'UNSUPPORTED_CAPABILITY',\n      `library '${library}' exposes no native client`,\n    );\n  }\n  const created = driver.createNativeClient();\n  internals.registerNative(created);\n  internals.nativeClients.set(library, created.client);\n  return created.client as NativeClientMap[L];\n}\n"]}

package/dist/testing/contracts/api.d.ts

@@ -0,0 +1,12 @@
+/** Minimal test-framework surface; pass wrappers around your framework's describe/it. */
+export interface ContractTestApi {
+    describe(name: string, fn: () => void): void;
+    it(name: string, fn: () => Promise<void>): void;
+}
+export declare function rejectsWithCode(promise: Promise<unknown>, code: string): Promise<void>;
+/**
+ * Everything an error carries as text (its message, its JSON form and its causes')
+ * leaves out each of `secrets`. Store keys embed wallet addresses, and error messages
+ * reach logs.
+ */
+export declare function rejectsWithCodeKeepingOut(promise: Promise<unknown>, code: string, secrets: readonly string[]): Promise<void>;

package/dist/testing/contracts/api.js

@@ -0,0 +1,58 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.rejectsWithCode = rejectsWithCode;
+exports.rejectsWithCodeKeepingOut = rejectsWithCodeKeepingOut;
+const strict_1 = __importDefault(require("node:assert/strict"));
+async function rejectsWithCode(promise, code) {
+    try {
+        await promise;
+    }
+    catch (error) {
+        strict_1.default.equal(error.code, code);
+        return;
+    }
+    strict_1.default.fail(`expected a rejection with code ${code}`);
+}
+/**
+ * Everything an error carries as text (its message, its JSON form and its causes')
+ * leaves out each of `secrets`. Store keys embed wallet addresses, and error messages
+ * reach logs.
+ */
+async function rejectsWithCodeKeepingOut(promise, code, secrets) {
+    let caught;
+    let rejected = false;
+    try {
+        await promise;
+    }
+    catch (error) {
+        caught = error;
+        rejected = true;
+    }
+    if (!rejected)
+        strict_1.default.fail(`expected a rejection with code ${code}`);
+    strict_1.default.equal(caught.code, code);
+    const text = textOf(caught);
+    for (const secret of secrets) {
+        strict_1.default.ok(!text.includes(secret), `a ${code} error names a store key`);
+    }
+}
+function textOf(error) {
+    const parts = [];
+    let current = error;
+    for (let depth = 0; depth < 8 && current !== undefined && current !== null; depth += 1) {
+        if (current instanceof Error)
+            parts.push(current.name, current.message);
+        try {
+            parts.push(JSON.stringify(current, (_key, value) => typeof value === 'bigint' ? value.toString() : value) ?? '');
+        }
+        catch {
+            parts.push(String(current));
+        }
+        current = current.cause;
+    }
+    return parts.join('\n');
+}
+//# sourceMappingURL=api.js.map

package/dist/testing/contracts/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../../src/testing/contracts/api.ts"],"names":[],"mappings":";;;;;AAQA,0CAWC;AAOD,8DAmBC;AA7CD,gEAAwC;AAQjC,KAAK,UAAU,eAAe,CACnC,OAAyB,EACzB,IAAY;IAEZ,IAAI,CAAC;QACH,MAAM,OAAO,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,gBAAM,CAAC,KAAK,CAAE,KAA4B,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACvD,OAAO;IACT,CAAC;IACD,gBAAM,CAAC,IAAI,CAAC,kCAAkC,IAAI,EAAE,CAAC,CAAC;AACxD,CAAC;AAED;;;;GAIG;AACI,KAAK,UAAU,yBAAyB,CAC7C,OAAyB,EACzB,IAAY,EACZ,OAA0B;IAE1B,IAAI,MAAe,CAAC;IACpB,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,CAAC;QACH,MAAM,OAAO,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,GAAG,KAAK,CAAC;QACf,QAAQ,GAAG,IAAI,CAAC;IAClB,CAAC;IACD,IAAI,CAAC,QAAQ;QAAE,gBAAM,CAAC,IAAI,CAAC,kCAAkC,IAAI,EAAE,CAAC,CAAC;IACrE,gBAAM,CAAC,KAAK,CAAE,MAA6B,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACxD,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,gBAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,IAAI,0BAA0B,CAAC,CAAC;IACzE,CAAC;AACH,CAAC;AAED,SAAS,MAAM,CAAC,KAAc;IAC5B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,KACE,IAAI,KAAK,GAAG,CAAC,EACb,KAAK,GAAG,CAAC,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,IAAI,EACtD,KAAK,IAAI,CAAC,EACV,CAAC;QACD,IAAI,OAAO,YAAY,KAAK;YAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QACxE,IAAI,CAAC;YACH,KAAK,CAAC,IAAI,CACR,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,KAAc,EAAE,EAAE,CAC/C,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,KAAK,CACrD,IAAI,EAAE,CACR,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QAC9B,CAAC;QACD,OAAO,GAAI,OAA+B,CAAC,KAAK,CAAC;IACnD,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC","sourcesContent":["import assert from 'node:assert/strict';\n\n/** Minimal test-framework surface; pass wrappers around your framework's describe/it. */\nexport interface ContractTestApi {\n  describe(name: string, fn: () => void): void;\n  it(name: string, fn: () => Promise<void>): void;\n}\n\nexport async function rejectsWithCode(\n  promise: Promise<unknown>,\n  code: string,\n): Promise<void> {\n  try {\n    await promise;\n  } catch (error) {\n    assert.equal((error as { code?: unknown }).code, code);\n    return;\n  }\n  assert.fail(`expected a rejection with code ${code}`);\n}\n\n/**\n * Everything an error carries as text (its message, its JSON form and its causes')\n * leaves out each of `secrets`. Store keys embed wallet addresses, and error messages\n * reach logs.\n */\nexport async function rejectsWithCodeKeepingOut(\n  promise: Promise<unknown>,\n  code: string,\n  secrets: readonly string[],\n): Promise<void> {\n  let caught: unknown;\n  let rejected = false;\n  try {\n    await promise;\n  } catch (error) {\n    caught = error;\n    rejected = true;\n  }\n  if (!rejected) assert.fail(`expected a rejection with code ${code}`);\n  assert.equal((caught as { code?: unknown }).code, code);\n  const text = textOf(caught);\n  for (const secret of secrets) {\n    assert.ok(!text.includes(secret), `a ${code} error names a store key`);\n  }\n}\n\nfunction textOf(error: unknown): string {\n  const parts: string[] = [];\n  let current = error;\n  for (\n    let depth = 0;\n    depth < 8 && current !== undefined && current !== null;\n    depth += 1\n  ) {\n    if (current instanceof Error) parts.push(current.name, current.message);\n    try {\n      parts.push(\n        JSON.stringify(current, (_key, value: unknown) =>\n          typeof value === 'bigint' ? value.toString() : value,\n        ) ?? '',\n      );\n    } catch {\n      parts.push(String(current));\n    }\n    current = (current as { cause?: unknown }).cause;\n  }\n  return parts.join('\\n');\n}\n"]}

package/dist/testing/contracts/cursors.d.ts

@@ -0,0 +1,6 @@
+import type { CursorStore } from '../../core/store/types';
+import { type ContractTestApi } from './api';
+export interface CursorHarness {
+    readonly cursors: CursorStore;
+}
+export declare function describeCursorStoreContract(api: ContractTestApi, create: () => CursorHarness | Promise<CursorHarness>): void;

package/dist/testing/contracts/cursors.js

@@ -0,0 +1,43 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.describeCursorStoreContract = describeCursorStoreContract;
+const strict_1 = __importDefault(require("node:assert/strict"));
+const api_1 = require("./api");
+function describeCursorStoreContract(api, create) {
+    api.describe('CursorStore contract', () => {
+        api.it('stores cursors with compare-and-set versions', async () => {
+            const { cursors } = await create();
+            strict_1.default.equal(await cursors.get('c'), null);
+            const cursor = {
+                height: 2n ** 40n,
+                hash: 'h1',
+                recent: [{ height: 2n ** 40n, hash: 'h1' }],
+            };
+            strict_1.default.equal(await cursors.put('c', cursor, null), 1);
+            strict_1.default.deepEqual(await cursors.get('c'), { cursor, version: 1 });
+            const updated = { ...cursor, hash: 'h2' };
+            strict_1.default.equal(await cursors.put('c', updated, 1), 2);
+            const stored = { cursor: updated, version: 2 };
+            strict_1.default.deepEqual(await cursors.get('c'), stored);
+            await (0, api_1.rejectsWithCode)(cursors.put('c', cursor, 1), 'VERSION_CONFLICT');
+            strict_1.default.deepEqual(await cursors.get('c'), stored);
+            await (0, api_1.rejectsWithCode)(cursors.put('c', cursor, null), 'VERSION_CONFLICT');
+            strict_1.default.deepEqual(await cursors.get('c'), stored);
+        });
+        api.it('keeps the key out of its errors', async () => {
+            // A cursor key can name a watched wallet, and error messages reach logs.
+            const { cursors } = await create();
+            const key = 'deposits:bitcoin:mainnet:bc1qcursorkeyc0ffee0000000000000000000000';
+            const cursor = { height: 1n, hash: 'h1', recent: [{ height: 1n, hash: 'h1' }] };
+            await cursors.put(key, cursor, null);
+            await (0, api_1.rejectsWithCodeKeepingOut)(cursors.put(key, cursor, null), 'VERSION_CONFLICT', [key]);
+            await (0, api_1.rejectsWithCodeKeepingOut)(cursors.put(key, cursor, 9), 'VERSION_CONFLICT', [
+                key,
+            ]);
+        });
+    });
+}
+//# sourceMappingURL=cursors.js.map

package/dist/testing/contracts/cursors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursors.js","sourceRoot":"","sources":["../../../src/testing/contracts/cursors.ts"],"names":[],"mappings":"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","sourcesContent":["import assert from 'node:assert/strict';\nimport type { CursorStore } from '../../core/store/types';\nimport { rejectsWithCode, rejectsWithCodeKeepingOut, type ContractTestApi } from './api';\n\nexport interface CursorHarness {\n  readonly cursors: CursorStore;\n}\n\nexport function describeCursorStoreContract(\n  api: ContractTestApi,\n  create: () => CursorHarness | Promise<CursorHarness>,\n): void {\n  api.describe('CursorStore contract', () => {\n    api.it('stores cursors with compare-and-set versions', async () => {\n      const { cursors } = await create();\n      assert.equal(await cursors.get('c'), null);\n      const cursor = {\n        height: 2n ** 40n,\n        hash: 'h1',\n        recent: [{ height: 2n ** 40n, hash: 'h1' }],\n      };\n      assert.equal(await cursors.put('c', cursor, null), 1);\n      assert.deepEqual(await cursors.get('c'), { cursor, version: 1 });\n      const updated = { ...cursor, hash: 'h2' };\n      assert.equal(await cursors.put('c', updated, 1), 2);\n      const stored = { cursor: updated, version: 2 };\n      assert.deepEqual(await cursors.get('c'), stored);\n      await rejectsWithCode(cursors.put('c', cursor, 1), 'VERSION_CONFLICT');\n      assert.deepEqual(await cursors.get('c'), stored);\n      await rejectsWithCode(cursors.put('c', cursor, null), 'VERSION_CONFLICT');\n      assert.deepEqual(await cursors.get('c'), stored);\n    });\n\n    api.it('keeps the key out of its errors', async () => {\n      // A cursor key can name a watched wallet, and error messages reach logs.\n      const { cursors } = await create();\n      const key = 'deposits:bitcoin:mainnet:bc1qcursorkeyc0ffee0000000000000000000000';\n      const cursor = { height: 1n, hash: 'h1', recent: [{ height: 1n, hash: 'h1' }] };\n      await cursors.put(key, cursor, null);\n      await rejectsWithCodeKeepingOut(\n        cursors.put(key, cursor, null),\n        'VERSION_CONFLICT',\n        [key],\n      );\n      await rejectsWithCodeKeepingOut(cursors.put(key, cursor, 9), 'VERSION_CONFLICT', [\n        key,\n      ]);\n    });\n  });\n}\n"]}

package/dist/testing/contracts/locks.d.ts

@@ -0,0 +1,10 @@
+import type { LockManager } from '../../core/store/types';
+import type { ContractTestApi } from './api';
+export interface LockHarness {
+    readonly locks: LockManager;
+    /** Moves the store's notion of time forward (a fake clock, or a real sleep). */
+    advance(ms: number): Promise<void>;
+}
+export declare function describeLockManagerContract(api: ContractTestApi, create: () => LockHarness | Promise<LockHarness>, options?: {
+    readonly ttlMs?: number;
+}): void;

package/dist/testing/contracts/locks.js

@@ -0,0 +1,63 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.describeLockManagerContract = describeLockManagerContract;
+const strict_1 = __importDefault(require("node:assert/strict"));
+function describeLockManagerContract(api, create, options = {}) {
+    const ttl = options.ttlMs ?? 1_000;
+    api.describe('LockManager contract', () => {
+        api.it('grants one holder at a time per key', async () => {
+            const { locks } = await create();
+            const a = await locks.acquire('k', 'a', ttl);
+            strict_1.default.ok(a);
+            strict_1.default.equal(a.owner, 'a');
+            strict_1.default.equal(await locks.acquire('k', 'b', ttl), null);
+            strict_1.default.equal(await locks.acquire('k', 'a', ttl), null, 'leases are not reentrant');
+            strict_1.default.ok(await locks.acquire('other', 'b', ttl), 'keys are independent');
+        });
+        api.it('issues strictly increasing tokens across expiry and release', async () => {
+            const { locks, advance } = await create();
+            const a = await locks.acquire('k', 'a', ttl);
+            strict_1.default.ok(a);
+            await advance(ttl + 1);
+            const b = await locks.acquire('k', 'b', ttl);
+            strict_1.default.ok(b);
+            strict_1.default.ok(b.token > a.token);
+            await locks.release(b);
+            const c = await locks.acquire('k', 'c', ttl);
+            strict_1.default.ok(c);
+            strict_1.default.ok(c.token > b.token);
+        });
+        api.it('rejects a stale worker after takeover', async () => {
+            const { locks, advance } = await create();
+            const stale = await locks.acquire('k', 'a', ttl);
+            strict_1.default.ok(stale);
+            await advance(ttl + 1);
+            const fresh = await locks.acquire('k', 'b', ttl);
+            strict_1.default.ok(fresh);
+            strict_1.default.equal(await locks.renew(stale, ttl), null);
+            await locks.release(stale);
+            strict_1.default.equal(await locks.acquire('k', 'c', ttl), null, 'stale release must not free the new holder');
+            strict_1.default.ok(await locks.renew(fresh, ttl));
+        });
+        api.it('renews before expiry but not after', async () => {
+            const { locks, advance } = await create();
+            const lease = await locks.acquire('k', 'a', ttl);
+            strict_1.default.ok(lease);
+            await advance(Math.floor(ttl / 2));
+            const renewed = await locks.renew(lease, ttl);
+            strict_1.default.ok(renewed);
+            strict_1.default.equal(renewed.token, lease.token);
+            await advance(ttl + 1);
+            strict_1.default.equal(await locks.renew(renewed, ttl), null);
+        });
+        api.it('grants exactly one lease to concurrent acquirers', async () => {
+            const { locks } = await create();
+            const results = await Promise.all(Array.from({ length: 10 }, (_, i) => locks.acquire('k', `w${i}`, ttl)));
+            strict_1.default.equal(results.filter(Boolean).length, 1);
+        });
+    });
+}
+//# sourceMappingURL=locks.js.map

package/dist/testing/contracts/locks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locks.js","sourceRoot":"","sources":["../../../src/testing/contracts/locks.ts"],"names":[],"mappings":"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","sourcesContent":["import assert from 'node:assert/strict';\nimport type { LockManager } from '../../core/store/types';\nimport type { ContractTestApi } from './api';\n\nexport interface LockHarness {\n  readonly locks: LockManager;\n  /** Moves the store's notion of time forward (a fake clock, or a real sleep). */\n  advance(ms: number): Promise<void>;\n}\n\nexport function describeLockManagerContract(\n  api: ContractTestApi,\n  create: () => LockHarness | Promise<LockHarness>,\n  options: { readonly ttlMs?: number } = {},\n): void {\n  const ttl = options.ttlMs ?? 1_000;\n  api.describe('LockManager contract', () => {\n    api.it('grants one holder at a time per key', async () => {\n      const { locks } = await create();\n      const a = await locks.acquire('k', 'a', ttl);\n      assert.ok(a);\n      assert.equal(a.owner, 'a');\n      assert.equal(await locks.acquire('k', 'b', ttl), null);\n      assert.equal(await locks.acquire('k', 'a', ttl), null, 'leases are not reentrant');\n      assert.ok(await locks.acquire('other', 'b', ttl), 'keys are independent');\n    });\n\n    api.it('issues strictly increasing tokens across expiry and release', async () => {\n      const { locks, advance } = await create();\n      const a = await locks.acquire('k', 'a', ttl);\n      assert.ok(a);\n      await advance(ttl + 1);\n      const b = await locks.acquire('k', 'b', ttl);\n      assert.ok(b);\n      assert.ok(b.token > a.token);\n      await locks.release(b);\n      const c = await locks.acquire('k', 'c', ttl);\n      assert.ok(c);\n      assert.ok(c.token > b.token);\n    });\n\n    api.it('rejects a stale worker after takeover', async () => {\n      const { locks, advance } = await create();\n      const stale = await locks.acquire('k', 'a', ttl);\n      assert.ok(stale);\n      await advance(ttl + 1);\n      const fresh = await locks.acquire('k', 'b', ttl);\n      assert.ok(fresh);\n      assert.equal(await locks.renew(stale, ttl), null);\n      await locks.release(stale);\n      assert.equal(\n        await locks.acquire('k', 'c', ttl),\n        null,\n        'stale release must not free the new holder',\n      );\n      assert.ok(await locks.renew(fresh, ttl));\n    });\n\n    api.it('renews before expiry but not after', async () => {\n      const { locks, advance } = await create();\n      const lease = await locks.acquire('k', 'a', ttl);\n      assert.ok(lease);\n      await advance(Math.floor(ttl / 2));\n      const renewed = await locks.renew(lease, ttl);\n      assert.ok(renewed);\n      assert.equal(renewed.token, lease.token);\n      await advance(ttl + 1);\n      assert.equal(await locks.renew(renewed, ttl), null);\n    });\n\n    api.it('grants exactly one lease to concurrent acquirers', async () => {\n      const { locks } = await create();\n      const results = await Promise.all(\n        Array.from({ length: 10 }, (_, i) => locks.acquire('k', `w${i}`, ttl)),\n      );\n      assert.equal(results.filter(Boolean).length, 1);\n    });\n  });\n}\n"]}