@domfi/sdk 0.1.0

package/dist/contracts.js

@@ -0,0 +1 @@
+export{a as compatibilityManifest,c as uncheckedCompatibilityReport,b as wagmiContracts}from'./chunk-N4Q67DTE.js';export{a as abis}from'./chunk-YU5DN3PI.js';

package/dist/delegation.cjs

@@ -0,0 +1 @@
+'use strict';

package/dist/delegation.d.cts

@@ -0,0 +1,7 @@
+import './types-DQft82W7.cjs';
+export { c as DelegationClient, an as DelegationReadOptions, ao as DelegationSendOptions, D as DelegationTarget, ap as DelegationTypedData, aq as DelegationTypedDataOptions, ar as DelegationTypedDataParams, as as SignedDelegation } from './types-DJBX-p4X.cjs';
+import './units.cjs';
+import './errors.cjs';
+import 'viem';
+import '@domfi/sdk/errors';
+import './referrals.cjs';

package/dist/delegation.d.ts

@@ -0,0 +1,7 @@
+import './types-7s13ZSql.js';
+export { c as DelegationClient, an as DelegationReadOptions, ao as DelegationSendOptions, D as DelegationTarget, ap as DelegationTypedData, aq as DelegationTypedDataOptions, ar as DelegationTypedDataParams, as as SignedDelegation } from './types-DDgJiEFg.js';
+import './units.js';
+import './errors.js';
+import 'viem';
+import '@domfi/sdk/errors';
+import './referrals.js';

package/dist/errors.cjs

@@ -0,0 +1,3 @@
+'use strict';var d={"0x00796158":"REVERT_INVALID_ORACLE_FEE_CLAIM_AMOUNT","0x0819bdcd":"REVERT_SIGNATURE_EXPIRED","0x083fbd78":"REVERT_WRONG_SL","0x084986e7":"REVERT_IS_DONE","0x093650d5":"REVERT_NOT_GOV","0x0b92ae2b":"REVERT_ORACLE_VALUE_UNSET","0x0efd6122":"REVERT_ABOVE_BALANCE","0x118cdaa7":"REVERT_OWNABLE_UNAUTHORIZED_ACCOUNT","0x1309a563":"REVERT_IS_PAUSED","0x177e802f":"REVERT_ERC721_INSUFFICIENT_APPROVAL","0x17e08e97":"REVERT_NO_TRADE_FOUND","0x1c49f4d1":"REVERT_INVALID_CALL_DATA","0x1e4fbdf7":"REVERT_OWNABLE_INVALID_OWNER","0x206e62e3":"REVERT_INSUFFICIENT_ORACLE_FEE_BALANCE","0x24775e06":"REVERT_SAFE_CAST_OVERFLOWED_UINT_TO_INT","0x2493b27e":"REVERT_ABOVE_MAX_DEPOSIT","0x25c20828":"REVERT_INVALID_TIMESTAMP","0x284ff667":"REVERT_ERC4626_EXCEEDED_MAX_MINT","0x28acd8e3":"REVERT_ORACLE_ONLY","0x2a19e833":"REVERT_NOT_MANAGER","0x2a917859":"REVERT_NO_DELEGATE","0x2f285798":"REVERT_DEPOSIT_NOT_UNLOCKED","0x327269a7":"REVERT_SAFE_CAST_OVERFLOWED_INT_DOWNCAST","0x35fe85c5":"REVERT_WRONG_LEVERAGE","0x3786fdd4":"REVERT_NOT_ENOUGH_ASSETS","0x39d9cf4f":"REVERT_PENDING_WITHDRAWAL","0x3d093e84":"REVERT_WAIT_NEXT_EPOCH_START","0x3e0b1869":"REVERT_WAIT_TIMEOUT","0x3f7084a5":"REVERT_NOT_TRADING_OR_CALLBACKS","0x432b6c83":"REVERT_NOT_TRADES_UP_KEEP","0x46c4ede2":"REVERT_EXPOSURE_LIMITS","0x46daa3ad":"REVERT_NOT_TRADING","0x4a0bfec1":"REVERT_NOT_AUTHORIZED","0x4a67a8d2":"REVERT_ABOVE_MAX_MINT","0x4f9cbad0":"REVERT_DELEGATE_REENTRANT","0x502b946d":"REVERT_NOT_DELEGATE","0x50725e4f":"REVERT_NO_ACTIVE_DISCOUNT","0x5274afe7":"REVERT_SAFE_ERC20_FAILED_OPERATION","0x5863f789":"REVERT_WRONG_PARAMS","0x59171fc1":"REVERT_ERC721_ENUMERABLE_FORBIDDEN_BATCH_MINT","0x5ac89f62":"REVERT_NOT_YOUR_ORDER","0x5b08ba18":"REVERT_ERC721_INVALID_OPERATOR","0x5be5878a":"REVERT_DELEGATED_ACTION_FAILED","0x5c12ea62":"REVERT_MAX_PENDING_MARKET_ORDERS_REACHED","0x64283d7b":"REVERT_ERC721_INCORRECT_OWNER","0x64a0ae92":"REVERT_ERC721_INVALID_RECEIVER","0x66a662b9":"REVERT_MAX_REACHED","0x68174b76":"REVERT_NOT_REGISTRY_OR_GOV","0x6bcd09d8":"REVERT_ABOVE_WITHDRAW_AMOUNT","0x6dfcc650":"REVERT_SAFE_CAST_OVERFLOWED_UINT_DOWNCAST","0x7195a895":"REVERT_NOT_OPEN_PNL","0x73c6ac6e":"REVERT_ERC721_INVALID_SENDER","0x756688fe":"REVERT_INVALID_NONCE","0x79012fb2":"REVERT_ERC4626_EXCEEDED_MAX_DEPOSIT","0x7e273289":"REVERT_ERC721_NONEXISTENT_TOKEN","0x80a71fc5":"REVERT_ABOVE_MAX_ALLOWED_COLLATERAL","0x89c62b64":"REVERT_ERC721_INVALID_OWNER","0x8a2747e5":"REVERT_FEE_NOT_LISTED","0x8aefb98e":"REVERT_NO_OPEN_LIMIT_ORDER","0x8baa579f":"REVERT_INVALID_SIGNATURE","0x92497ff7":"REVERT_INVALID_ORACLE_FEE","0x94280d62":"REVERT_ERC20_INVALID_SPENDER","0x9589a27d":"REVERT_INVALID_ORACLE","0x96c6fd1e":"REVERT_ERC20_INVALID_SENDER","0x9fb82783":"REVERT_INVALID_ORACLE_STATUS","0xa1c00d42":"REVERT_PAIR_NOT_LISTED","0xa35ee470":"REVERT_NO_LIMIT_FOUND","0xa41bb918":"REVERT_WRONG_TP","0xa4e993e1":"REVERT_NO_DISCOUNT","0xa57d13dc":"REVERT_ERC721_OUT_OF_BOUNDS_INDEX","0xa8ce4432":"REVERT_SAFE_CAST_OVERFLOWED_INT_TO_UINT","0xa9fbf51f":"REVERT_ERC721_INVALID_APPROVER","0xabbf79aa":"REVERT_GROUP_NOT_LISTED","0xb09e78ce":"REVERT_DELEGATE_FORBIDDEN","0xb6efd7c6":"REVERT_PAIR_NOT_EMPTY","0xb94abeec":"REVERT_ERC4626_EXCEEDED_MAX_REDEEM","0xbc011219":"REVERT_NOT_TRADES_UP_KEEP_OR_TRADING","0xbd3cb648":"REVERT_MAX_DAILY_PNL_REACHED","0xbde4d0f1":"REVERT_NOT_CALLBACKS","0xcb87b762":"REVERT_PAIR_NOT_LISTED","0xcd2110ba":"REVERT_NOT_CALLBACKS_OR_TRADES_UP_KEEP_OR_TRADING","0xcd8fa092":"REVERT_NOT_CALLBACKS_OR_TRADES_UP_KEEP","0xcdc993c4":"REVERT_NULL_PRICE","0xd1f721ee":"REVERT_WRONG_LOCK_DURATION","0xd7e6bcf8":"REVERT_NOT_INITIALIZING","0xdd9397bb":"REVERT_TRIGGER_PENDING","0xddff77db":"REVERT_INVALID_DEV_FEE_CLAIM_AMOUNT","0xdface737":"REVERT_PAIR_ALREADY_LISTED","0xe450d38c":"REVERT_ERC20_INSUFFICIENT_BALANCE","0xe5a74490":"REVERT_NULL_AMOUNT","0xe602df05":"REVERT_ERC20_INVALID_APPROVER","0xe6f47fab":"REVERT_MAX_TRADES_PER_PAIR_REACHED","0xe9d60161":"REVERT_NOT_VAULT","0xec442f05":"REVERT_ERC20_INVALID_RECEIVER","0xeca695e1":"REVERT_BELOW_MIN_LEV_POS","0xefa9e5be":"REVERT_NO_TRADE_TO_TIMEOUT_FOUND","0xf3d0b126":"REVERT_NULL_ADDR","0xf77a8069":"REVERT_ALREADY_MARKET_CLOSED","0xf92ee8a9":"REVERT_INVALID_INITIALIZATION","0xfa5cd00f":"REVERT_NOT_ALLOWED","0xfb550858":"REVERT_INSUFFICIENT_ORACLE_FEE","0xfb8f41b2":"REVERT_ERC20_INSUFFICIENT_ALLOWANCE","0xfc33f1bd":"REVERT_NOT_EMPTY_INDEX","0xfe9cceec":"REVERT_ERC4626_EXCEEDED_MAX_WITHDRAW"};var y=["transport","validation","config","wallet","api","contract","compatibility","identity","timeout","abort"],U=new Set(y),h=["MISSING_API_CLIENT","MISSING_PUBLIC_CLIENT","MISSING_WALLET_CLIENT","MISSING_ACCOUNT","WALLET_CHAIN_MISMATCH","WALLET_ACCOUNT_MISMATCH","WALLET_DISCONNECTED","READ_MODEL_NOT_READY","PROTOCOL_COMPATIBILITY_MISMATCH","IDENTITY_MISMATCH","VALIDATION_ERROR","API_ERROR","CONTRACT_REVERT","ORACLE_FEE_CAP_EXCEEDED","TIMEOUT","ABORTED","TRANSPORT_ERROR"],w=new Set(h);function v(e){return R(e)&&typeof e.name=="string"&&typeof e.message=="string"&&F(e.code)&&G(e.kind)&&typeof e.transient=="boolean"&&H(e.diagnostics)&&k(e.hash)&&X(e.httpStatus)&&K(e.details)&&_(e.hint)}function F(e){return typeof e!="string"?false:w.has(e)||e.startsWith("API_")||e.startsWith("REVERT_")}function G(e){return typeof e=="string"&&U.has(e)}function H(e){return R(e)&&typeof e.sdkVersion=="string"&&typeof e.sourceTag=="string"&&Number.isFinite(e.chainId)&&_(e.schemaHash)&&_(e.liveSchemaHash)&&k(e.registryAddress)&&s(e.valuationBlock)&&W(e.apiFreshness)&&_(e.requestId)&&B(e.compatibilityStatus)}function W(e){return e===void 0?true:R(e)&&typeof e.source=="string"&&typeof e.generatedAt=="string"&&s(e.indexedBlock)&&s(e.chainHeadBlock)&&s(e.lagBlocks)&&_(e.cacheStatus)&&s(e.cacheAgeSeconds)&&typeof e.isStale=="boolean"}function B(e){return e===void 0||e==="ok"||e==="mismatch"||e==="unchecked"}function _(e){return e===void 0||typeof e=="string"}function X(e){return e===void 0||typeof e=="number"}function s(e){return e===void 0||typeof e=="bigint"}function k(e){return e===void 0||typeof e=="string"&&e.startsWith("0x")}function K(e){return e===void 0||R(e)}var t=class extends Error{code;kind;transient;hash;hint;diagnostics;cause;constructor(n){super(n.message),this.name=new.target.name,this.code=n.code,this.kind=n.kind,this.transient=n.transient,this.diagnostics=n.diagnostics,n.hash!==void 0&&(this.hash=n.hash),n.hint!==void 0&&(this.hint=n.hint),n.cause!==void 0&&(this.cause=n.cause);}},A=class extends t{constructor(n){super({...n,code:"MISSING_API_CLIENT",kind:"config",transient:false});}},f=class extends t{constructor(n){super({...n,code:"MISSING_PUBLIC_CLIENT",kind:"config",transient:false});}},N=class extends t{constructor(n){super({...n,code:"MISSING_WALLET_CLIENT",kind:"wallet",transient:false});}},O=class extends t{constructor(n){super({...n,code:"MISSING_ACCOUNT",kind:"wallet",transient:false});}},C=class extends t{constructor(n){super({...n,code:"WALLET_CHAIN_MISMATCH",kind:"wallet",transient:false});}},D=class extends t{constructor(n){super({...n,code:"WALLET_ACCOUNT_MISMATCH",kind:"wallet",transient:false});}},u=class extends t{constructor(n){super({...n,code:"WALLET_DISCONNECTED",kind:"wallet",transient:true});}},L=class extends t{constructor(n){super({...n,code:"READ_MODEL_NOT_READY",kind:"api",transient:true});}},x=class extends t{constructor(n){super({...n,code:"PROTOCOL_COMPATIBILITY_MISMATCH",kind:"compatibility",transient:false});}},S=class extends t{constructor(n){super({...n,code:"IDENTITY_MISMATCH",kind:"identity",transient:false});}},V=class extends t{constructor(n){super({...n,code:"VALIDATION_ERROR",kind:"validation",transient:false});}},l=class extends t{httpStatus;details;constructor(n){super({...n,code:n.code??"API_ERROR",kind:"api",transient:n.transient??false}),n.httpStatus!==void 0&&(this.httpStatus=n.httpStatus),n.details!==void 0&&(this.details=n.details);}},p=class extends t{constructor(n){super({...n,code:"TRANSPORT_ERROR",kind:"transport",transient:n.transient??true});}};function R(e){return typeof e=="object"&&e!==null}function M(e){if(typeof e!="string"||!/^0x[0-9a-fA-F]{8}/.test(e))return;let n=e.slice(0,10).toLowerCase();return n in d?n:void 0}function i(e,n=0){if(n>8)return;let E=M(e);if(E!==void 0)return E;if(!R(e))return;let o=M(e.data);if(o!==void 0)return o;let T=i(e.data,n+1);if(T!==void 0)return T;let a=i(e.cause,n+1);return a!==void 0?a:i(e.error,n+1)}var Y=new Set(["RawContractError","ContractFunctionRevertedError","ExecutionRevertedError"]);function r(e,n){let E=e[n];return typeof E=="string"?E:void 0}function c(e,n=0){if(n>8||!R(e))return  false;let E=r(e,"name"),o=r(e,"message")??"",T=r(e,"shortMessage")??"",a=e.code;return E==="UserRejectedRequestError"||a===4001||/user rejected/i.test(o)||/user rejected/i.test(T)?true:c(e.cause,n+1)||c(e.error,n+1)}function $(e){let n=r(e,"message")??"",E=r(e,"shortMessage")??"",o=r(e,"details")??"";return /execution reverted|contract function .*reverted/i.test(`${n}
+${E}
+${o}`)}function I(e,n=0){if(n>8)return  false;if(i(e)!==void 0)return  true;if(!R(e))return  false;let E=r(e,"name");return E!==void 0&&Y.has(E)||$(e)?true:I(e.cause,n+1)||I(e.error,n+1)}function z(e){return c(e)?false:I(e)}function j(e){let n=i(e);return n===void 0?"CONTRACT_REVERT":d[n]}var g=class extends t{constructor(n){super({...n,code:n.code??j(n.cause),kind:"contract",transient:false});}},b=class extends t{constructor(n){super({...n,code:"ORACLE_FEE_CAP_EXCEEDED",kind:"validation",transient:false});}},m=class extends t{constructor(n){super({...n,code:"TIMEOUT",kind:"timeout",transient:true});}},P=class extends t{constructor(n){super({...n,code:"ABORTED",kind:"abort",transient:true});}};exports.AbortError=P;exports.ApiError=l;exports.ContractRevertError=g;exports.IdentityMismatchError=S;exports.MissingAccountError=O;exports.MissingApiClientError=A;exports.MissingPublicClientError=f;exports.MissingWalletClientError=N;exports.OracleFeeCapExceededError=b;exports.ProtocolCompatibilityMismatchError=x;exports.ReadModelNotReadyError=L;exports.TimeoutError=m;exports.TransportError=p;exports.ValidationError=V;exports.WalletAccountMismatchError=D;exports.WalletChainMismatchError=C;exports.WalletDisconnectedError=u;exports.isContractRevertLikeError=z;exports.isDomfiError=v;

package/dist/errors.d.cts

@@ -0,0 +1,155 @@
+import { Address, IsoTimestamp, Hex } from './units.cjs';
+
+/** Broad SDK error category for grouping handling logic. */
+type DomfiErrorKind = "transport" | "validation" | "config" | "wallet" | "api" | "contract" | "compatibility" | "identity" | "timeout" | "abort";
+/** Stable SDK error code. API and contract errors may use prefixed dynamic codes. */
+type DomfiErrorCode = "MISSING_API_CLIENT" | "MISSING_PUBLIC_CLIENT" | "MISSING_WALLET_CLIENT" | "MISSING_ACCOUNT" | "WALLET_CHAIN_MISMATCH" | "WALLET_ACCOUNT_MISMATCH" | "WALLET_DISCONNECTED" | "READ_MODEL_NOT_READY" | "PROTOCOL_COMPATIBILITY_MISMATCH" | "IDENTITY_MISMATCH" | "VALIDATION_ERROR" | "API_ERROR" | "CONTRACT_REVERT" | "ORACLE_FEE_CAP_EXCEEDED" | "TIMEOUT" | "ABORTED" | "TRANSPORT_ERROR";
+type Freshness = {
+    source: string;
+    generatedAt: IsoTimestamp;
+    indexedBlock?: bigint;
+    chainHeadBlock?: bigint;
+    lagBlocks?: bigint;
+    cacheStatus?: string;
+    cacheAgeSeconds?: bigint;
+    isStale: boolean;
+};
+/** Diagnostics attached to SDK errors and REST result envelopes. */
+type DiagnosticsEnvelope = {
+    sdkVersion: string;
+    sourceTag: string;
+    schemaHash?: string;
+    liveSchemaHash?: string;
+    chainId: number;
+    registryAddress?: Address;
+    valuationBlock?: bigint;
+    apiFreshness?: Freshness;
+    requestId?: string;
+    compatibilityStatus?: "ok" | "mismatch" | "unchecked";
+};
+/** Common shape implemented by all SDK-defined errors. */
+interface DomfiError extends Error {
+    readonly name: string;
+    readonly code: DomfiErrorCode | `API_${string}` | `REVERT_${string}`;
+    readonly kind: DomfiErrorKind;
+    readonly transient: boolean;
+    readonly hash?: Hex;
+    readonly httpStatus?: number;
+    readonly details?: Record<string, unknown>;
+    readonly hint?: string;
+    readonly diagnostics: DiagnosticsEnvelope;
+    readonly cause?: unknown;
+}
+/** Type guard for SDK-defined errors and compatible serialized error objects. */
+declare function isDomfiError(error: unknown): error is DomfiError;
+/** Common constructor fields for SDK-defined errors. */
+type DomfiErrorInit = {
+    message: string;
+    diagnostics: DiagnosticsEnvelope;
+    hash?: Hex;
+    hint?: string;
+    cause?: unknown;
+};
+/** Constructor fields for REST API errors. */
+type ApiErrorInit = DomfiErrorInit & {
+    code?: "API_ERROR" | `API_${string}`;
+    httpStatus?: number;
+    transient?: boolean;
+    details?: Record<string, unknown>;
+};
+/** Constructor fields for contract revert errors. */
+type ContractRevertErrorInit = DomfiErrorInit & {
+    code?: "CONTRACT_REVERT" | `REVERT_${string}`;
+};
+/** Constructor fields for transport errors. */
+type TransportErrorInit = DomfiErrorInit & {
+    transient?: boolean;
+};
+declare class DomfiBaseError<Code extends DomfiError["code"], Kind extends DomfiErrorKind, Transient extends boolean> extends Error implements DomfiError {
+    readonly code: Code;
+    readonly kind: Kind;
+    readonly transient: Transient;
+    readonly hash?: Hex;
+    readonly hint?: string;
+    readonly diagnostics: DiagnosticsEnvelope;
+    readonly cause?: unknown;
+    constructor(init: DomfiErrorInit & {
+        code: Code;
+        kind: Kind;
+        transient: Transient;
+    });
+}
+/** Thrown when an API-only helper is called on an RPC-only client. */
+declare class MissingApiClientError extends DomfiBaseError<"MISSING_API_CLIENT", "config", false> {
+    constructor(init: DomfiErrorInit);
+}
+/** Thrown when an RPC read/simulation requires a public client that was not configured. */
+declare class MissingPublicClientError extends DomfiBaseError<"MISSING_PUBLIC_CLIENT", "config", false> {
+    constructor(init: DomfiErrorInit);
+}
+/** Thrown when a write helper requires a wallet client that was not configured. */
+declare class MissingWalletClientError extends DomfiBaseError<"MISSING_WALLET_CLIENT", "wallet", false> {
+    constructor(init: DomfiErrorInit);
+}
+/** Thrown when a wallet/account-scoped helper cannot resolve an account. */
+declare class MissingAccountError extends DomfiBaseError<"MISSING_ACCOUNT", "wallet", false> {
+    constructor(init: DomfiErrorInit);
+}
+/** Thrown when the configured wallet client is connected to an unexpected chain. */
+declare class WalletChainMismatchError extends DomfiBaseError<"WALLET_CHAIN_MISMATCH", "wallet", false> {
+    constructor(init: DomfiErrorInit);
+}
+/** Thrown when the configured wallet account does not match the requested account. */
+declare class WalletAccountMismatchError extends DomfiBaseError<"WALLET_ACCOUNT_MISMATCH", "wallet", false> {
+    constructor(init: DomfiErrorInit);
+}
+/** Transient wallet failure indicating the wallet is disconnected or unavailable. */
+declare class WalletDisconnectedError extends DomfiBaseError<"WALLET_DISCONNECTED", "wallet", true> {
+    constructor(init: DomfiErrorInit);
+}
+/** Transient REST readiness failure when strict reads reject stale or incomplete models. */
+declare class ReadModelNotReadyError extends DomfiBaseError<"READ_MODEL_NOT_READY", "api", true> {
+    constructor(init: DomfiErrorInit);
+}
+/** Thrown when SDK metadata does not match the target protocol deployment. */
+declare class ProtocolCompatibilityMismatchError extends DomfiBaseError<"PROTOCOL_COMPATIBILITY_MISMATCH", "compatibility", false> {
+    constructor(init: DomfiErrorInit);
+}
+/** Thrown when indexed order/position identity does not match the caller's expectation. */
+declare class IdentityMismatchError extends DomfiBaseError<"IDENTITY_MISMATCH", "identity", false> {
+    constructor(init: DomfiErrorInit);
+}
+/** Thrown for invalid SDK inputs, malformed remote payloads, or impossible parsed state. */
+declare class ValidationError extends DomfiBaseError<"VALIDATION_ERROR", "validation", false> {
+    constructor(init: DomfiErrorInit);
+}
+/** REST API error with optional HTTP status and structured response details. */
+declare class ApiError extends DomfiBaseError<"API_ERROR" | `API_${string}`, "api", boolean> {
+    readonly httpStatus?: number;
+    readonly details?: Record<string, unknown>;
+    constructor(init: ApiErrorInit);
+}
+/** Network, fetch, timeout-wrapper, or custom transport failure. */
+declare class TransportError extends DomfiBaseError<"TRANSPORT_ERROR", "transport", boolean> {
+    constructor(init: TransportErrorInit);
+}
+/** Returns true when an unknown provider error looks like an execution revert. */
+declare function isContractRevertLikeError(error: unknown): boolean;
+/** Contract execution revert, optionally mapped to a generated `REVERT_*` selector code. */
+declare class ContractRevertError extends DomfiBaseError<"CONTRACT_REVERT" | `REVERT_${string}`, "contract", false> {
+    constructor(init: ContractRevertErrorInit);
+}
+/** Thrown when a write would exceed the caller's maximum oracle fee cap. */
+declare class OracleFeeCapExceededError extends DomfiBaseError<"ORACLE_FEE_CAP_EXCEEDED", "validation", false> {
+    constructor(init: DomfiErrorInit);
+}
+/** Transient SDK timeout from REST requests, RPC polling, or watch loops. */
+declare class TimeoutError extends DomfiBaseError<"TIMEOUT", "timeout", true> {
+    constructor(init: DomfiErrorInit);
+}
+/** Transient abort caused by a caller-provided `AbortSignal`. */
+declare class AbortError extends DomfiBaseError<"ABORTED", "abort", true> {
+    constructor(init: DomfiErrorInit);
+}
+
+export { AbortError, ApiError, type ApiErrorInit, ContractRevertError, type ContractRevertErrorInit, type DiagnosticsEnvelope, type DomfiError, type DomfiErrorCode, type DomfiErrorInit, type DomfiErrorKind, IdentityMismatchError, MissingAccountError, MissingApiClientError, MissingPublicClientError, MissingWalletClientError, OracleFeeCapExceededError, ProtocolCompatibilityMismatchError, ReadModelNotReadyError, TimeoutError, TransportError, type TransportErrorInit, ValidationError, WalletAccountMismatchError, WalletChainMismatchError, WalletDisconnectedError, isContractRevertLikeError, isDomfiError };

package/dist/errors.d.ts

@@ -0,0 +1,155 @@
+import { Address, IsoTimestamp, Hex } from './units.js';
+
+/** Broad SDK error category for grouping handling logic. */
+type DomfiErrorKind = "transport" | "validation" | "config" | "wallet" | "api" | "contract" | "compatibility" | "identity" | "timeout" | "abort";
+/** Stable SDK error code. API and contract errors may use prefixed dynamic codes. */
+type DomfiErrorCode = "MISSING_API_CLIENT" | "MISSING_PUBLIC_CLIENT" | "MISSING_WALLET_CLIENT" | "MISSING_ACCOUNT" | "WALLET_CHAIN_MISMATCH" | "WALLET_ACCOUNT_MISMATCH" | "WALLET_DISCONNECTED" | "READ_MODEL_NOT_READY" | "PROTOCOL_COMPATIBILITY_MISMATCH" | "IDENTITY_MISMATCH" | "VALIDATION_ERROR" | "API_ERROR" | "CONTRACT_REVERT" | "ORACLE_FEE_CAP_EXCEEDED" | "TIMEOUT" | "ABORTED" | "TRANSPORT_ERROR";
+type Freshness = {
+    source: string;
+    generatedAt: IsoTimestamp;
+    indexedBlock?: bigint;
+    chainHeadBlock?: bigint;
+    lagBlocks?: bigint;
+    cacheStatus?: string;
+    cacheAgeSeconds?: bigint;
+    isStale: boolean;
+};
+/** Diagnostics attached to SDK errors and REST result envelopes. */
+type DiagnosticsEnvelope = {
+    sdkVersion: string;
+    sourceTag: string;
+    schemaHash?: string;
+    liveSchemaHash?: string;
+    chainId: number;
+    registryAddress?: Address;
+    valuationBlock?: bigint;
+    apiFreshness?: Freshness;
+    requestId?: string;
+    compatibilityStatus?: "ok" | "mismatch" | "unchecked";
+};
+/** Common shape implemented by all SDK-defined errors. */
+interface DomfiError extends Error {
+    readonly name: string;
+    readonly code: DomfiErrorCode | `API_${string}` | `REVERT_${string}`;
+    readonly kind: DomfiErrorKind;
+    readonly transient: boolean;
+    readonly hash?: Hex;
+    readonly httpStatus?: number;
+    readonly details?: Record<string, unknown>;
+    readonly hint?: string;
+    readonly diagnostics: DiagnosticsEnvelope;
+    readonly cause?: unknown;
+}
+/** Type guard for SDK-defined errors and compatible serialized error objects. */
+declare function isDomfiError(error: unknown): error is DomfiError;
+/** Common constructor fields for SDK-defined errors. */
+type DomfiErrorInit = {
+    message: string;
+    diagnostics: DiagnosticsEnvelope;
+    hash?: Hex;
+    hint?: string;
+    cause?: unknown;
+};
+/** Constructor fields for REST API errors. */
+type ApiErrorInit = DomfiErrorInit & {
+    code?: "API_ERROR" | `API_${string}`;
+    httpStatus?: number;
+    transient?: boolean;
+    details?: Record<string, unknown>;
+};
+/** Constructor fields for contract revert errors. */
+type ContractRevertErrorInit = DomfiErrorInit & {
+    code?: "CONTRACT_REVERT" | `REVERT_${string}`;
+};
+/** Constructor fields for transport errors. */
+type TransportErrorInit = DomfiErrorInit & {
+    transient?: boolean;
+};
+declare class DomfiBaseError<Code extends DomfiError["code"], Kind extends DomfiErrorKind, Transient extends boolean> extends Error implements DomfiError {
+    readonly code: Code;
+    readonly kind: Kind;
+    readonly transient: Transient;
+    readonly hash?: Hex;
+    readonly hint?: string;
+    readonly diagnostics: DiagnosticsEnvelope;
+    readonly cause?: unknown;
+    constructor(init: DomfiErrorInit & {
+        code: Code;
+        kind: Kind;
+        transient: Transient;
+    });
+}
+/** Thrown when an API-only helper is called on an RPC-only client. */
+declare class MissingApiClientError extends DomfiBaseError<"MISSING_API_CLIENT", "config", false> {
+    constructor(init: DomfiErrorInit);
+}
+/** Thrown when an RPC read/simulation requires a public client that was not configured. */
+declare class MissingPublicClientError extends DomfiBaseError<"MISSING_PUBLIC_CLIENT", "config", false> {
+    constructor(init: DomfiErrorInit);
+}
+/** Thrown when a write helper requires a wallet client that was not configured. */
+declare class MissingWalletClientError extends DomfiBaseError<"MISSING_WALLET_CLIENT", "wallet", false> {
+    constructor(init: DomfiErrorInit);
+}
+/** Thrown when a wallet/account-scoped helper cannot resolve an account. */
+declare class MissingAccountError extends DomfiBaseError<"MISSING_ACCOUNT", "wallet", false> {
+    constructor(init: DomfiErrorInit);
+}
+/** Thrown when the configured wallet client is connected to an unexpected chain. */
+declare class WalletChainMismatchError extends DomfiBaseError<"WALLET_CHAIN_MISMATCH", "wallet", false> {
+    constructor(init: DomfiErrorInit);
+}
+/** Thrown when the configured wallet account does not match the requested account. */
+declare class WalletAccountMismatchError extends DomfiBaseError<"WALLET_ACCOUNT_MISMATCH", "wallet", false> {
+    constructor(init: DomfiErrorInit);
+}
+/** Transient wallet failure indicating the wallet is disconnected or unavailable. */
+declare class WalletDisconnectedError extends DomfiBaseError<"WALLET_DISCONNECTED", "wallet", true> {
+    constructor(init: DomfiErrorInit);
+}
+/** Transient REST readiness failure when strict reads reject stale or incomplete models. */
+declare class ReadModelNotReadyError extends DomfiBaseError<"READ_MODEL_NOT_READY", "api", true> {
+    constructor(init: DomfiErrorInit);
+}
+/** Thrown when SDK metadata does not match the target protocol deployment. */
+declare class ProtocolCompatibilityMismatchError extends DomfiBaseError<"PROTOCOL_COMPATIBILITY_MISMATCH", "compatibility", false> {
+    constructor(init: DomfiErrorInit);
+}
+/** Thrown when indexed order/position identity does not match the caller's expectation. */
+declare class IdentityMismatchError extends DomfiBaseError<"IDENTITY_MISMATCH", "identity", false> {
+    constructor(init: DomfiErrorInit);
+}
+/** Thrown for invalid SDK inputs, malformed remote payloads, or impossible parsed state. */
+declare class ValidationError extends DomfiBaseError<"VALIDATION_ERROR", "validation", false> {
+    constructor(init: DomfiErrorInit);
+}
+/** REST API error with optional HTTP status and structured response details. */
+declare class ApiError extends DomfiBaseError<"API_ERROR" | `API_${string}`, "api", boolean> {
+    readonly httpStatus?: number;
+    readonly details?: Record<string, unknown>;
+    constructor(init: ApiErrorInit);
+}
+/** Network, fetch, timeout-wrapper, or custom transport failure. */
+declare class TransportError extends DomfiBaseError<"TRANSPORT_ERROR", "transport", boolean> {
+    constructor(init: TransportErrorInit);
+}
+/** Returns true when an unknown provider error looks like an execution revert. */
+declare function isContractRevertLikeError(error: unknown): boolean;
+/** Contract execution revert, optionally mapped to a generated `REVERT_*` selector code. */
+declare class ContractRevertError extends DomfiBaseError<"CONTRACT_REVERT" | `REVERT_${string}`, "contract", false> {
+    constructor(init: ContractRevertErrorInit);
+}
+/** Thrown when a write would exceed the caller's maximum oracle fee cap. */
+declare class OracleFeeCapExceededError extends DomfiBaseError<"ORACLE_FEE_CAP_EXCEEDED", "validation", false> {
+    constructor(init: DomfiErrorInit);
+}
+/** Transient SDK timeout from REST requests, RPC polling, or watch loops. */
+declare class TimeoutError extends DomfiBaseError<"TIMEOUT", "timeout", true> {
+    constructor(init: DomfiErrorInit);
+}
+/** Transient abort caused by a caller-provided `AbortSignal`. */
+declare class AbortError extends DomfiBaseError<"ABORTED", "abort", true> {
+    constructor(init: DomfiErrorInit);
+}
+
+export { AbortError, ApiError, type ApiErrorInit, ContractRevertError, type ContractRevertErrorInit, type DiagnosticsEnvelope, type DomfiError, type DomfiErrorCode, type DomfiErrorInit, type DomfiErrorKind, IdentityMismatchError, MissingAccountError, MissingApiClientError, MissingPublicClientError, MissingWalletClientError, OracleFeeCapExceededError, ProtocolCompatibilityMismatchError, ReadModelNotReadyError, TimeoutError, TransportError, type TransportErrorInit, ValidationError, WalletAccountMismatchError, WalletChainMismatchError, WalletDisconnectedError, isContractRevertLikeError, isDomfiError };

package/dist/errors.js

@@ -0,0 +1,3 @@
+var d={"0x00796158":"REVERT_INVALID_ORACLE_FEE_CLAIM_AMOUNT","0x0819bdcd":"REVERT_SIGNATURE_EXPIRED","0x083fbd78":"REVERT_WRONG_SL","0x084986e7":"REVERT_IS_DONE","0x093650d5":"REVERT_NOT_GOV","0x0b92ae2b":"REVERT_ORACLE_VALUE_UNSET","0x0efd6122":"REVERT_ABOVE_BALANCE","0x118cdaa7":"REVERT_OWNABLE_UNAUTHORIZED_ACCOUNT","0x1309a563":"REVERT_IS_PAUSED","0x177e802f":"REVERT_ERC721_INSUFFICIENT_APPROVAL","0x17e08e97":"REVERT_NO_TRADE_FOUND","0x1c49f4d1":"REVERT_INVALID_CALL_DATA","0x1e4fbdf7":"REVERT_OWNABLE_INVALID_OWNER","0x206e62e3":"REVERT_INSUFFICIENT_ORACLE_FEE_BALANCE","0x24775e06":"REVERT_SAFE_CAST_OVERFLOWED_UINT_TO_INT","0x2493b27e":"REVERT_ABOVE_MAX_DEPOSIT","0x25c20828":"REVERT_INVALID_TIMESTAMP","0x284ff667":"REVERT_ERC4626_EXCEEDED_MAX_MINT","0x28acd8e3":"REVERT_ORACLE_ONLY","0x2a19e833":"REVERT_NOT_MANAGER","0x2a917859":"REVERT_NO_DELEGATE","0x2f285798":"REVERT_DEPOSIT_NOT_UNLOCKED","0x327269a7":"REVERT_SAFE_CAST_OVERFLOWED_INT_DOWNCAST","0x35fe85c5":"REVERT_WRONG_LEVERAGE","0x3786fdd4":"REVERT_NOT_ENOUGH_ASSETS","0x39d9cf4f":"REVERT_PENDING_WITHDRAWAL","0x3d093e84":"REVERT_WAIT_NEXT_EPOCH_START","0x3e0b1869":"REVERT_WAIT_TIMEOUT","0x3f7084a5":"REVERT_NOT_TRADING_OR_CALLBACKS","0x432b6c83":"REVERT_NOT_TRADES_UP_KEEP","0x46c4ede2":"REVERT_EXPOSURE_LIMITS","0x46daa3ad":"REVERT_NOT_TRADING","0x4a0bfec1":"REVERT_NOT_AUTHORIZED","0x4a67a8d2":"REVERT_ABOVE_MAX_MINT","0x4f9cbad0":"REVERT_DELEGATE_REENTRANT","0x502b946d":"REVERT_NOT_DELEGATE","0x50725e4f":"REVERT_NO_ACTIVE_DISCOUNT","0x5274afe7":"REVERT_SAFE_ERC20_FAILED_OPERATION","0x5863f789":"REVERT_WRONG_PARAMS","0x59171fc1":"REVERT_ERC721_ENUMERABLE_FORBIDDEN_BATCH_MINT","0x5ac89f62":"REVERT_NOT_YOUR_ORDER","0x5b08ba18":"REVERT_ERC721_INVALID_OPERATOR","0x5be5878a":"REVERT_DELEGATED_ACTION_FAILED","0x5c12ea62":"REVERT_MAX_PENDING_MARKET_ORDERS_REACHED","0x64283d7b":"REVERT_ERC721_INCORRECT_OWNER","0x64a0ae92":"REVERT_ERC721_INVALID_RECEIVER","0x66a662b9":"REVERT_MAX_REACHED","0x68174b76":"REVERT_NOT_REGISTRY_OR_GOV","0x6bcd09d8":"REVERT_ABOVE_WITHDRAW_AMOUNT","0x6dfcc650":"REVERT_SAFE_CAST_OVERFLOWED_UINT_DOWNCAST","0x7195a895":"REVERT_NOT_OPEN_PNL","0x73c6ac6e":"REVERT_ERC721_INVALID_SENDER","0x756688fe":"REVERT_INVALID_NONCE","0x79012fb2":"REVERT_ERC4626_EXCEEDED_MAX_DEPOSIT","0x7e273289":"REVERT_ERC721_NONEXISTENT_TOKEN","0x80a71fc5":"REVERT_ABOVE_MAX_ALLOWED_COLLATERAL","0x89c62b64":"REVERT_ERC721_INVALID_OWNER","0x8a2747e5":"REVERT_FEE_NOT_LISTED","0x8aefb98e":"REVERT_NO_OPEN_LIMIT_ORDER","0x8baa579f":"REVERT_INVALID_SIGNATURE","0x92497ff7":"REVERT_INVALID_ORACLE_FEE","0x94280d62":"REVERT_ERC20_INVALID_SPENDER","0x9589a27d":"REVERT_INVALID_ORACLE","0x96c6fd1e":"REVERT_ERC20_INVALID_SENDER","0x9fb82783":"REVERT_INVALID_ORACLE_STATUS","0xa1c00d42":"REVERT_PAIR_NOT_LISTED","0xa35ee470":"REVERT_NO_LIMIT_FOUND","0xa41bb918":"REVERT_WRONG_TP","0xa4e993e1":"REVERT_NO_DISCOUNT","0xa57d13dc":"REVERT_ERC721_OUT_OF_BOUNDS_INDEX","0xa8ce4432":"REVERT_SAFE_CAST_OVERFLOWED_INT_TO_UINT","0xa9fbf51f":"REVERT_ERC721_INVALID_APPROVER","0xabbf79aa":"REVERT_GROUP_NOT_LISTED","0xb09e78ce":"REVERT_DELEGATE_FORBIDDEN","0xb6efd7c6":"REVERT_PAIR_NOT_EMPTY","0xb94abeec":"REVERT_ERC4626_EXCEEDED_MAX_REDEEM","0xbc011219":"REVERT_NOT_TRADES_UP_KEEP_OR_TRADING","0xbd3cb648":"REVERT_MAX_DAILY_PNL_REACHED","0xbde4d0f1":"REVERT_NOT_CALLBACKS","0xcb87b762":"REVERT_PAIR_NOT_LISTED","0xcd2110ba":"REVERT_NOT_CALLBACKS_OR_TRADES_UP_KEEP_OR_TRADING","0xcd8fa092":"REVERT_NOT_CALLBACKS_OR_TRADES_UP_KEEP","0xcdc993c4":"REVERT_NULL_PRICE","0xd1f721ee":"REVERT_WRONG_LOCK_DURATION","0xd7e6bcf8":"REVERT_NOT_INITIALIZING","0xdd9397bb":"REVERT_TRIGGER_PENDING","0xddff77db":"REVERT_INVALID_DEV_FEE_CLAIM_AMOUNT","0xdface737":"REVERT_PAIR_ALREADY_LISTED","0xe450d38c":"REVERT_ERC20_INSUFFICIENT_BALANCE","0xe5a74490":"REVERT_NULL_AMOUNT","0xe602df05":"REVERT_ERC20_INVALID_APPROVER","0xe6f47fab":"REVERT_MAX_TRADES_PER_PAIR_REACHED","0xe9d60161":"REVERT_NOT_VAULT","0xec442f05":"REVERT_ERC20_INVALID_RECEIVER","0xeca695e1":"REVERT_BELOW_MIN_LEV_POS","0xefa9e5be":"REVERT_NO_TRADE_TO_TIMEOUT_FOUND","0xf3d0b126":"REVERT_NULL_ADDR","0xf77a8069":"REVERT_ALREADY_MARKET_CLOSED","0xf92ee8a9":"REVERT_INVALID_INITIALIZATION","0xfa5cd00f":"REVERT_NOT_ALLOWED","0xfb550858":"REVERT_INSUFFICIENT_ORACLE_FEE","0xfb8f41b2":"REVERT_ERC20_INSUFFICIENT_ALLOWANCE","0xfc33f1bd":"REVERT_NOT_EMPTY_INDEX","0xfe9cceec":"REVERT_ERC4626_EXCEEDED_MAX_WITHDRAW"};var y=["transport","validation","config","wallet","api","contract","compatibility","identity","timeout","abort"],U=new Set(y),h=["MISSING_API_CLIENT","MISSING_PUBLIC_CLIENT","MISSING_WALLET_CLIENT","MISSING_ACCOUNT","WALLET_CHAIN_MISMATCH","WALLET_ACCOUNT_MISMATCH","WALLET_DISCONNECTED","READ_MODEL_NOT_READY","PROTOCOL_COMPATIBILITY_MISMATCH","IDENTITY_MISMATCH","VALIDATION_ERROR","API_ERROR","CONTRACT_REVERT","ORACLE_FEE_CAP_EXCEEDED","TIMEOUT","ABORTED","TRANSPORT_ERROR"],w=new Set(h);function v(e){return R(e)&&typeof e.name=="string"&&typeof e.message=="string"&&F(e.code)&&G(e.kind)&&typeof e.transient=="boolean"&&H(e.diagnostics)&&k(e.hash)&&X(e.httpStatus)&&K(e.details)&&_(e.hint)}function F(e){return typeof e!="string"?false:w.has(e)||e.startsWith("API_")||e.startsWith("REVERT_")}function G(e){return typeof e=="string"&&U.has(e)}function H(e){return R(e)&&typeof e.sdkVersion=="string"&&typeof e.sourceTag=="string"&&Number.isFinite(e.chainId)&&_(e.schemaHash)&&_(e.liveSchemaHash)&&k(e.registryAddress)&&s(e.valuationBlock)&&W(e.apiFreshness)&&_(e.requestId)&&B(e.compatibilityStatus)}function W(e){return e===void 0?true:R(e)&&typeof e.source=="string"&&typeof e.generatedAt=="string"&&s(e.indexedBlock)&&s(e.chainHeadBlock)&&s(e.lagBlocks)&&_(e.cacheStatus)&&s(e.cacheAgeSeconds)&&typeof e.isStale=="boolean"}function B(e){return e===void 0||e==="ok"||e==="mismatch"||e==="unchecked"}function _(e){return e===void 0||typeof e=="string"}function X(e){return e===void 0||typeof e=="number"}function s(e){return e===void 0||typeof e=="bigint"}function k(e){return e===void 0||typeof e=="string"&&e.startsWith("0x")}function K(e){return e===void 0||R(e)}var t=class extends Error{code;kind;transient;hash;hint;diagnostics;cause;constructor(n){super(n.message),this.name=new.target.name,this.code=n.code,this.kind=n.kind,this.transient=n.transient,this.diagnostics=n.diagnostics,n.hash!==void 0&&(this.hash=n.hash),n.hint!==void 0&&(this.hint=n.hint),n.cause!==void 0&&(this.cause=n.cause);}},A=class extends t{constructor(n){super({...n,code:"MISSING_API_CLIENT",kind:"config",transient:false});}},f=class extends t{constructor(n){super({...n,code:"MISSING_PUBLIC_CLIENT",kind:"config",transient:false});}},N=class extends t{constructor(n){super({...n,code:"MISSING_WALLET_CLIENT",kind:"wallet",transient:false});}},O=class extends t{constructor(n){super({...n,code:"MISSING_ACCOUNT",kind:"wallet",transient:false});}},C=class extends t{constructor(n){super({...n,code:"WALLET_CHAIN_MISMATCH",kind:"wallet",transient:false});}},D=class extends t{constructor(n){super({...n,code:"WALLET_ACCOUNT_MISMATCH",kind:"wallet",transient:false});}},u=class extends t{constructor(n){super({...n,code:"WALLET_DISCONNECTED",kind:"wallet",transient:true});}},L=class extends t{constructor(n){super({...n,code:"READ_MODEL_NOT_READY",kind:"api",transient:true});}},x=class extends t{constructor(n){super({...n,code:"PROTOCOL_COMPATIBILITY_MISMATCH",kind:"compatibility",transient:false});}},S=class extends t{constructor(n){super({...n,code:"IDENTITY_MISMATCH",kind:"identity",transient:false});}},V=class extends t{constructor(n){super({...n,code:"VALIDATION_ERROR",kind:"validation",transient:false});}},l=class extends t{httpStatus;details;constructor(n){super({...n,code:n.code??"API_ERROR",kind:"api",transient:n.transient??false}),n.httpStatus!==void 0&&(this.httpStatus=n.httpStatus),n.details!==void 0&&(this.details=n.details);}},p=class extends t{constructor(n){super({...n,code:"TRANSPORT_ERROR",kind:"transport",transient:n.transient??true});}};function R(e){return typeof e=="object"&&e!==null}function M(e){if(typeof e!="string"||!/^0x[0-9a-fA-F]{8}/.test(e))return;let n=e.slice(0,10).toLowerCase();return n in d?n:void 0}function i(e,n=0){if(n>8)return;let E=M(e);if(E!==void 0)return E;if(!R(e))return;let o=M(e.data);if(o!==void 0)return o;let T=i(e.data,n+1);if(T!==void 0)return T;let a=i(e.cause,n+1);return a!==void 0?a:i(e.error,n+1)}var Y=new Set(["RawContractError","ContractFunctionRevertedError","ExecutionRevertedError"]);function r(e,n){let E=e[n];return typeof E=="string"?E:void 0}function c(e,n=0){if(n>8||!R(e))return  false;let E=r(e,"name"),o=r(e,"message")??"",T=r(e,"shortMessage")??"",a=e.code;return E==="UserRejectedRequestError"||a===4001||/user rejected/i.test(o)||/user rejected/i.test(T)?true:c(e.cause,n+1)||c(e.error,n+1)}function $(e){let n=r(e,"message")??"",E=r(e,"shortMessage")??"",o=r(e,"details")??"";return /execution reverted|contract function .*reverted/i.test(`${n}
+${E}
+${o}`)}function I(e,n=0){if(n>8)return  false;if(i(e)!==void 0)return  true;if(!R(e))return  false;let E=r(e,"name");return E!==void 0&&Y.has(E)||$(e)?true:I(e.cause,n+1)||I(e.error,n+1)}function z(e){return c(e)?false:I(e)}function j(e){let n=i(e);return n===void 0?"CONTRACT_REVERT":d[n]}var g=class extends t{constructor(n){super({...n,code:n.code??j(n.cause),kind:"contract",transient:false});}},b=class extends t{constructor(n){super({...n,code:"ORACLE_FEE_CAP_EXCEEDED",kind:"validation",transient:false});}},m=class extends t{constructor(n){super({...n,code:"TIMEOUT",kind:"timeout",transient:true});}},P=class extends t{constructor(n){super({...n,code:"ABORTED",kind:"abort",transient:true});}};export{P as AbortError,l as ApiError,g as ContractRevertError,S as IdentityMismatchError,O as MissingAccountError,A as MissingApiClientError,f as MissingPublicClientError,N as MissingWalletClientError,b as OracleFeeCapExceededError,x as ProtocolCompatibilityMismatchError,L as ReadModelNotReadyError,m as TimeoutError,p as TransportError,V as ValidationError,D as WalletAccountMismatchError,C as WalletChainMismatchError,u as WalletDisconnectedError,z as isContractRevertLikeError,v as isDomfiError};