@ryanrfox/sdk 0.0.2 → 2.0.3

package/src/_esm/errors/base.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Radius SDK Error Hierarchy
+ *
+ * Extends viem's BaseError for ecosystem compatibility.
+ * All Radius errors can be caught using `instanceof BaseError` from viem.
+ */
+import { BaseError } from 'viem';
+/**
+ * Options for creating a RadiusError
+ */
+export interface RadiusErrorOptions {
+    /** Detailed error information */
+    details?: string;
+    /** URL path to relevant documentation */
+    docsPath?: string;
+    /** The underlying cause of this error */
+    cause?: BaseError | Error | undefined;
+    /** Additional hint messages to help resolve the error */
+    metaMessages?: string[];
+    /** Additional metadata about the error (Radius-specific extension) */
+    meta?: Record<string, unknown>;
+}
+/**
+ * Base error class for all Radius SDK errors.
+ *
+ * Extends viem's BaseError for ecosystem compatibility. This means:
+ * - `error instanceof BaseError` from viem will catch Radius errors
+ * - Compatible with wagmi error handling
+ * - Inherits viem's error formatting and walk() method
+ *
+ * @example
+ * ```typescript
+ * import { BaseError } from 'viem';
+ *
+ * try {
+ *   await walletClient.sendTransaction({ to, value });
+ * } catch (error) {
+ *   if (error instanceof RadiusError) {
+ *     console.log(error.shortMessage); // Quick description
+ *     console.log(error.details);      // Full details
+ *     console.log(error.docsPath);     // Link to docs
+ *   }
+ *   // Also works with viem's BaseError check
+ *   if (error instanceof BaseError) {
+ *     console.log('Caught viem-compatible error');
+ *   }
+ * }
+ * ```
+ */
+export declare class RadiusError extends BaseError {
+    /** Additional metadata (Radius-specific extension) */
+    readonly meta?: Record<string, unknown>;
+    name: string;
+    constructor(shortMessage: string, options?: RadiusErrorOptions);
+}
+//# sourceMappingURL=base.d.ts.map

package/src/_esm/errors/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../errors/base.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAEjC;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,KAAK,CAAC,EAAE,SAAS,GAAG,KAAK,GAAG,SAAS,CAAC;IACtC,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,sEAAsE;IACtE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,WAAY,SAAQ,SAAS;IACzC,sDAAsD;IACtD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE/B,IAAI,SAAiB;gBAElB,YAAY,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB;CAYlE"}

package/src/_esm/errors/base.js

@@ -0,0 +1,51 @@
+/**
+ * Radius SDK Error Hierarchy
+ *
+ * Extends viem's BaseError for ecosystem compatibility.
+ * All Radius errors can be caught using `instanceof BaseError` from viem.
+ */
+import { BaseError } from 'viem';
+/**
+ * Base error class for all Radius SDK errors.
+ *
+ * Extends viem's BaseError for ecosystem compatibility. This means:
+ * - `error instanceof BaseError` from viem will catch Radius errors
+ * - Compatible with wagmi error handling
+ * - Inherits viem's error formatting and walk() method
+ *
+ * @example
+ * ```typescript
+ * import { BaseError } from 'viem';
+ *
+ * try {
+ *   await walletClient.sendTransaction({ to, value });
+ * } catch (error) {
+ *   if (error instanceof RadiusError) {
+ *     console.log(error.shortMessage); // Quick description
+ *     console.log(error.details);      // Full details
+ *     console.log(error.docsPath);     // Link to docs
+ *   }
+ *   // Also works with viem's BaseError check
+ *   if (error instanceof BaseError) {
+ *     console.log('Caught viem-compatible error');
+ *   }
+ * }
+ * ```
+ */
+export class RadiusError extends BaseError {
+    /** Additional metadata (Radius-specific extension) */
+    meta;
+    name = 'RadiusError';
+    constructor(shortMessage, options = {}) {
+        super(shortMessage, {
+            cause: options.cause,
+            details: options.details,
+            docsPath: options.docsPath,
+            docsBaseUrl: 'https://docs.radiustech.xyz',
+            metaMessages: options.metaMessages,
+            name: 'RadiusError',
+        });
+        this.meta = options.meta;
+    }
+}
+//# sourceMappingURL=base.js.map

package/src/_esm/errors/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../errors/base.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAkBjC;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,OAAO,WAAY,SAAQ,SAAS;IACzC,sDAAsD;IAC7C,IAAI,CAA2B;IAE/B,IAAI,GAAG,aAAa,CAAC;IAE9B,YAAY,YAAoB,EAAE,UAA8B,EAAE;QACjE,KAAK,CAAC,YAAY,EAAE;YACnB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,WAAW,EAAE,6BAA6B;YAC1C,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,IAAI,EAAE,aAAa;SACnB,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAC1B,CAAC;CACD"}

package/src/_esm/errors/contract.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Contract-related errors
+ */
+import type { Address, Hex } from 'viem';
+import { RadiusError, type RadiusErrorOptions } from './base';
+/**
+ * Error thrown when a contract call fails.
+ */
+export declare class ContractCallError extends RadiusError {
+    readonly name = "ContractCallError";
+    /** The contract address */
+    readonly contractAddress?: Address;
+    /** The function name that was called */
+    readonly functionName?: string;
+    /** The arguments passed to the function */
+    readonly args?: readonly unknown[];
+    constructor(message: string, options?: RadiusErrorOptions & {
+        contractAddress?: Address;
+        functionName?: string;
+        args?: readonly unknown[];
+    });
+}
+/**
+ * Error thrown when contract deployment fails.
+ */
+export declare class ContractDeploymentError extends RadiusError {
+    readonly name = "ContractDeploymentError";
+    /** The contract bytecode */
+    readonly bytecode?: Hex;
+    /** The constructor arguments */
+    readonly constructorArgs?: readonly unknown[];
+    constructor(message: string, options?: RadiusErrorOptions & {
+        bytecode?: Hex;
+        constructorArgs?: readonly unknown[];
+    });
+}
+/**
+ * Error thrown when ABI encoding/decoding fails.
+ */
+export declare class AbiError extends RadiusError {
+    readonly name = "AbiError";
+    constructor(message: string, options?: RadiusErrorOptions);
+}
+/**
+ * Error thrown when a required contract ABI is missing.
+ */
+export declare class MissingAbiError extends RadiusError {
+    readonly name = "MissingAbiError";
+    constructor(message?: string, options?: RadiusErrorOptions);
+}
+//# sourceMappingURL=contract.d.ts.map

package/src/_esm/errors/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../errors/contract.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAE9D;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,WAAW;IACjD,SAAkB,IAAI,uBAAuB;IAE7C,2BAA2B;IAC3B,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;IACnC,wCAAwC;IACxC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,2CAA2C;IAC3C,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;gBAGlC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,kBAAkB,GAAG;QAC7B,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,IAAI,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;KACrB;CAUP;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,WAAW;IACvD,SAAkB,IAAI,6BAA6B;IAEnD,4BAA4B;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,GAAG,CAAC;IACxB,gCAAgC;IAChC,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;gBAG7C,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,kBAAkB,GAAG;QAC7B,QAAQ,CAAC,EAAE,GAAG,CAAC;QACf,eAAe,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;KAChC;CASP;AAED;;GAEG;AACH,qBAAa,QAAS,SAAQ,WAAW;IACxC,SAAkB,IAAI,cAAc;gBAExB,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB;CAM7D;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,WAAW;IAC/C,SAAkB,IAAI,qBAAqB;gBAE/B,OAAO,SAA6B,EAAE,OAAO,GAAE,kBAAuB;CAMlF"}

package/src/_esm/errors/contract.js

@@ -0,0 +1,65 @@
+import { RadiusError } from './base';
+/**
+ * Error thrown when a contract call fails.
+ */
+export class ContractCallError extends RadiusError {
+    name = 'ContractCallError';
+    /** The contract address */
+    contractAddress;
+    /** The function name that was called */
+    functionName;
+    /** The arguments passed to the function */
+    args;
+    constructor(message, options = {}) {
+        super(message, {
+            ...options,
+            docsPath: options.docsPath ?? '/docs/sdk/errors#contract-call',
+        });
+        this.contractAddress = options.contractAddress;
+        this.functionName = options.functionName;
+        this.args = options.args;
+    }
+}
+/**
+ * Error thrown when contract deployment fails.
+ */
+export class ContractDeploymentError extends RadiusError {
+    name = 'ContractDeploymentError';
+    /** The contract bytecode */
+    bytecode;
+    /** The constructor arguments */
+    constructorArgs;
+    constructor(message, options = {}) {
+        super(message, {
+            ...options,
+            docsPath: options.docsPath ?? '/docs/sdk/errors#contract-deployment',
+        });
+        this.bytecode = options.bytecode;
+        this.constructorArgs = options.constructorArgs;
+    }
+}
+/**
+ * Error thrown when ABI encoding/decoding fails.
+ */
+export class AbiError extends RadiusError {
+    name = 'AbiError';
+    constructor(message, options = {}) {
+        super(message, {
+            ...options,
+            docsPath: options.docsPath ?? '/docs/sdk/errors#abi',
+        });
+    }
+}
+/**
+ * Error thrown when a required contract ABI is missing.
+ */
+export class MissingAbiError extends RadiusError {
+    name = 'MissingAbiError';
+    constructor(message = 'Contract ABI is required', options = {}) {
+        super(message, {
+            ...options,
+            docsPath: options.docsPath ?? '/docs/sdk/errors#missing-abi',
+        });
+    }
+}
+//# sourceMappingURL=contract.js.map

package/src/_esm/errors/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../../errors/contract.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAA2B,MAAM,QAAQ,CAAC;AAE9D;;GAEG;AACH,MAAM,OAAO,iBAAkB,SAAQ,WAAW;IAC/B,IAAI,GAAG,mBAAmB,CAAC;IAE7C,2BAA2B;IAClB,eAAe,CAAW;IACnC,wCAAwC;IAC/B,YAAY,CAAU;IAC/B,2CAA2C;IAClC,IAAI,CAAsB;IAEnC,YACC,OAAe,EACf,UAII,EAAE;QAEN,KAAK,CAAC,OAAO,EAAE;YACd,GAAG,OAAO;YACV,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,gCAAgC;SAC9D,CAAC,CAAC;QACH,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;QAC/C,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAC1B,CAAC;CACD;AAED;;GAEG;AACH,MAAM,OAAO,uBAAwB,SAAQ,WAAW;IACrC,IAAI,GAAG,yBAAyB,CAAC;IAEnD,4BAA4B;IACnB,QAAQ,CAAO;IACxB,gCAAgC;IACvB,eAAe,CAAsB;IAE9C,YACC,OAAe,EACf,UAGI,EAAE;QAEN,KAAK,CAAC,OAAO,EAAE;YACd,GAAG,OAAO;YACV,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,sCAAsC;SACpE,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAChD,CAAC;CACD;AAED;;GAEG;AACH,MAAM,OAAO,QAAS,SAAQ,WAAW;IACtB,IAAI,GAAG,UAAU,CAAC;IAEpC,YAAY,OAAe,EAAE,UAA8B,EAAE;QAC5D,KAAK,CAAC,OAAO,EAAE;YACd,GAAG,OAAO;YACV,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,sBAAsB;SACpD,CAAC,CAAC;IACJ,CAAC;CACD;AAED;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,WAAW;IAC7B,IAAI,GAAG,iBAAiB,CAAC;IAE3C,YAAY,OAAO,GAAG,0BAA0B,EAAE,UAA8B,EAAE;QACjF,KAAK,CAAC,OAAO,EAAE;YACd,GAAG,OAAO;YACV,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,8BAA8B;SAC5D,CAAC,CAAC;IACJ,CAAC;CACD"}

package/src/_esm/errors/index.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Radius SDK Error Types
+ *
+ * This module provides a rich error hierarchy for better error handling
+ * and debugging. All errors extend RadiusError which provides:
+ * - Short messages for quick understanding
+ * - Detailed error information
+ * - Documentation links
+ * - Error cause chain traversal via .walk()
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   RadiusError,
+ *   TransactionFailedError,
+ *   InsufficientBalanceError,
+ * } from '@radiustechsystems/sdk';
+ *
+ * try {
+ *   await client.sendTransaction({ to, value });
+ * } catch (error) {
+ *   if (error instanceof InsufficientBalanceError) {
+ *     console.log('Not enough funds:', error.balance, 'required:', error.required);
+ *   } else if (error instanceof TransactionFailedError) {
+ *     console.log('Transaction failed:', error.transactionHash);
+ *   } else if (error instanceof RadiusError) {
+ *     console.log('SDK error:', error.shortMessage);
+ *   }
+ * }
+ * ```
+ */
+export { InsufficientBalanceError, InvalidAddressError, InvalidPrivateKeyError, SignerNotFoundError, SigningError, } from './account.js';
+export { RadiusError, type RadiusErrorOptions } from './base.js';
+export { AbiError, ContractCallError, ContractDeploymentError, MissingAbiError, } from './contract.js';
+export { BatchTransactionError, type BatchTransactionResult, GasEstimationError, NonceError, TransactionFailedError, TransactionRevertedError, TransactionTimeoutError, } from './transaction.js';
+/**
+ * Error types that can be thrown by sendTransaction operations.
+ */
+export type SendTransactionErrorType = InsufficientBalanceError | TransactionFailedError | TransactionRevertedError | TransactionTimeoutError | SignerNotFoundError | GasEstimationError | NonceError;
+/**
+ * Error types that can be thrown by batch transaction operations.
+ */
+export type BatchTransactionErrorType = BatchTransactionError | GasEstimationError | NonceError;
+/**
+ * Error types that can be thrown by contract call operations.
+ */
+export type CallContractErrorType = ContractCallError | MissingAbiError | AbiError;
+/**
+ * Error types that can be thrown by contract execution operations.
+ */
+export type ExecuteContractErrorType = ContractCallError | TransactionFailedError | TransactionRevertedError | SignerNotFoundError | GasEstimationError | MissingAbiError | AbiError;
+/**
+ * Error types that can be thrown by contract deployment operations.
+ */
+export type DeployContractErrorType = ContractDeploymentError | TransactionFailedError | TransactionRevertedError | SignerNotFoundError | GasEstimationError | AbiError;
+/**
+ * Error types that can be thrown by signing operations.
+ */
+export type SigningErrorType = SigningError | SignerNotFoundError | InvalidPrivateKeyError;
+import type { InsufficientBalanceError, InvalidPrivateKeyError, SignerNotFoundError, SigningError } from './account.js';
+import type { AbiError, ContractCallError, ContractDeploymentError, MissingAbiError } from './contract.js';
+import type { BatchTransactionError, GasEstimationError, NonceError, TransactionFailedError, TransactionRevertedError, TransactionTimeoutError } from './transaction.js';
+//# sourceMappingURL=index.d.ts.map

package/src/_esm/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../errors/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAGH,OAAO,EACN,wBAAwB,EACxB,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,EACnB,YAAY,GACZ,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAGjE,OAAO,EACN,QAAQ,EACR,iBAAiB,EACjB,uBAAuB,EACvB,eAAe,GACf,MAAM,eAAe,CAAC;AAGvB,OAAO,EACN,qBAAqB,EACrB,KAAK,sBAAsB,EAC3B,kBAAkB,EAClB,UAAU,EACV,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,GACvB,MAAM,kBAAkB,CAAC;AAG1B;;GAEG;AACH,MAAM,MAAM,wBAAwB,GACjC,wBAAwB,GACxB,sBAAsB,GACtB,wBAAwB,GACxB,uBAAuB,GACvB,mBAAmB,GACnB,kBAAkB,GAClB,UAAU,CAAC;AAEd;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,qBAAqB,GAAG,kBAAkB,GAAG,UAAU,CAAC;AAEhG;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,iBAAiB,GAAG,eAAe,GAAG,QAAQ,CAAC;AAEnF;;GAEG;AACH,MAAM,MAAM,wBAAwB,GACjC,iBAAiB,GACjB,sBAAsB,GACtB,wBAAwB,GACxB,mBAAmB,GACnB,kBAAkB,GAClB,eAAe,GACf,QAAQ,CAAC;AAEZ;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAChC,uBAAuB,GACvB,sBAAsB,GACtB,wBAAwB,GACxB,mBAAmB,GACnB,kBAAkB,GAClB,QAAQ,CAAC;AAEZ;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG,mBAAmB,GAAG,sBAAsB,CAAC;AAG3F,OAAO,KAAK,EACX,wBAAwB,EACxB,sBAAsB,EACtB,mBAAmB,EACnB,YAAY,EACZ,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EACX,QAAQ,EACR,iBAAiB,EACjB,uBAAuB,EACvB,eAAe,EACf,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EACX,qBAAqB,EACrB,kBAAkB,EAClB,UAAU,EACV,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,EACvB,MAAM,kBAAkB,CAAC"}

package/src/_esm/errors/index.js

@@ -0,0 +1,40 @@
+/**
+ * Radius SDK Error Types
+ *
+ * This module provides a rich error hierarchy for better error handling
+ * and debugging. All errors extend RadiusError which provides:
+ * - Short messages for quick understanding
+ * - Detailed error information
+ * - Documentation links
+ * - Error cause chain traversal via .walk()
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   RadiusError,
+ *   TransactionFailedError,
+ *   InsufficientBalanceError,
+ * } from '@radiustechsystems/sdk';
+ *
+ * try {
+ *   await client.sendTransaction({ to, value });
+ * } catch (error) {
+ *   if (error instanceof InsufficientBalanceError) {
+ *     console.log('Not enough funds:', error.balance, 'required:', error.required);
+ *   } else if (error instanceof TransactionFailedError) {
+ *     console.log('Transaction failed:', error.transactionHash);
+ *   } else if (error instanceof RadiusError) {
+ *     console.log('SDK error:', error.shortMessage);
+ *   }
+ * }
+ * ```
+ */
+// Account errors
+export { InsufficientBalanceError, InvalidAddressError, InvalidPrivateKeyError, SignerNotFoundError, SigningError, } from './account.js';
+// Base error
+export { RadiusError } from './base.js';
+// Contract errors
+export { AbiError, ContractCallError, ContractDeploymentError, MissingAbiError, } from './contract.js';
+// Transaction errors
+export { BatchTransactionError, GasEstimationError, NonceError, TransactionFailedError, TransactionRevertedError, TransactionTimeoutError, } from './transaction.js';
+//# sourceMappingURL=index.js.map

package/src/_esm/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../errors/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,iBAAiB;AACjB,OAAO,EACN,wBAAwB,EACxB,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,EACnB,YAAY,GACZ,MAAM,cAAc,CAAC;AACtB,aAAa;AACb,OAAO,EAAE,WAAW,EAA2B,MAAM,WAAW,CAAC;AAEjE,kBAAkB;AAClB,OAAO,EACN,QAAQ,EACR,iBAAiB,EACjB,uBAAuB,EACvB,eAAe,GACf,MAAM,eAAe,CAAC;AAEvB,qBAAqB;AACrB,OAAO,EACN,qBAAqB,EAErB,kBAAkB,EAClB,UAAU,EACV,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,GACvB,MAAM,kBAAkB,CAAC"}

package/src/_esm/errors/transaction.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Transaction-related errors
+ */
+import type { Address, Hash, Hex } from 'viem';
+import { RadiusError, type RadiusErrorOptions } from './base';
+/**
+ * Error thrown when a transaction fails to execute.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await walletClient.sendTransaction({ to, value });
+ * } catch (error) {
+ *   if (error instanceof TransactionFailedError) {
+ *     console.log('Transaction failed:', error.transactionHash);
+ *     console.log('Reason:', error.shortMessage);
+ *   }
+ * }
+ * ```
+ */
+export declare class TransactionFailedError extends RadiusError {
+    readonly name = "TransactionFailedError";
+    /** The transaction hash (if available) */
+    readonly transactionHash?: Hash;
+    /** The reason for failure */
+    readonly reason?: string;
+    constructor(message: string, options?: RadiusErrorOptions & {
+        transactionHash?: Hash;
+        reason?: string;
+    });
+}
+/**
+ * Error thrown when a transaction reverts on-chain.
+ */
+export declare class TransactionRevertedError extends RadiusError {
+    readonly name = "TransactionRevertedError";
+    /** The transaction hash (if available) */
+    readonly transactionHash?: Hash;
+    /** The reason for failure */
+    readonly reason?: string;
+    /** The revert reason (decoded if available) */
+    readonly revertReason?: string;
+    /** The raw revert data */
+    readonly revertData?: Hex;
+    constructor(message: string, options?: RadiusErrorOptions & {
+        transactionHash?: Hash;
+        reason?: string;
+        revertReason?: string;
+        revertData?: Hex;
+    });
+}
+/**
+ * Error thrown when gas estimation fails.
+ */
+export declare class GasEstimationError extends RadiusError {
+    readonly name = "GasEstimationError";
+    /** The address being called */
+    readonly to?: Address;
+    /** The call data */
+    readonly data?: Hex;
+    constructor(message: string, options?: RadiusErrorOptions & {
+        to?: Address;
+        data?: Hex;
+    });
+}
+/**
+ * Error thrown when transaction nonce is invalid.
+ */
+export declare class NonceError extends RadiusError {
+    readonly name = "NonceError";
+    /** The nonce that was used */
+    readonly nonce?: number;
+    /** The expected nonce */
+    readonly expectedNonce?: number;
+    constructor(message: string, options?: RadiusErrorOptions & {
+        nonce?: number;
+        expectedNonce?: number;
+    });
+}
+/**
+ * Error thrown when a transaction times out waiting for confirmation.
+ */
+export declare class TransactionTimeoutError extends RadiusError {
+    readonly name = "TransactionTimeoutError";
+    /** The transaction hash */
+    readonly transactionHash?: Hash;
+    /** How long we waited (in ms) */
+    readonly timeout?: number;
+    constructor(message: string, options?: RadiusErrorOptions & {
+        transactionHash?: Hash;
+        timeout?: number;
+    });
+}
+/**
+ * Result of a single transaction in a batch.
+ */
+export interface BatchTransactionResult {
+    /** The index of this transaction in the batch */
+    index: number;
+    /** The transaction hash (if successful) */
+    hash?: Hash;
+    /** The error message (if failed) */
+    error?: string;
+}
+/**
+ * Error thrown when one or more transactions in a batch fail.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await walletClient.sendTransactionBatch({ transactions });
+ * } catch (error) {
+ *   if (error instanceof BatchTransactionError) {
+ *     console.log('Batch failed:', error.message);
+ *     error.results.forEach((r, i) => {
+ *       if (r.error) {
+ *         console.log(`  Transaction ${i} failed: ${r.error}`);
+ *       } else {
+ *         console.log(`  Transaction ${i} succeeded: ${r.hash}`);
+ *       }
+ *     });
+ *   }
+ * }
+ * ```
+ */
+export declare class BatchTransactionError extends RadiusError {
+    readonly name = "BatchTransactionError";
+    /** Results for each transaction in the batch */
+    readonly results: BatchTransactionResult[];
+    constructor(message: string, results: BatchTransactionResult[], options?: RadiusErrorOptions);
+}
+//# sourceMappingURL=transaction.d.ts.map

package/src/_esm/errors/transaction.d.ts.map

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

package/src/_esm/errors/transaction.js

@@ -0,0 +1,143 @@
+import { RadiusError } from './base';
+/**
+ * Error thrown when a transaction fails to execute.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await walletClient.sendTransaction({ to, value });
+ * } catch (error) {
+ *   if (error instanceof TransactionFailedError) {
+ *     console.log('Transaction failed:', error.transactionHash);
+ *     console.log('Reason:', error.shortMessage);
+ *   }
+ * }
+ * ```
+ */
+export class TransactionFailedError extends RadiusError {
+    name = 'TransactionFailedError';
+    /** The transaction hash (if available) */
+    transactionHash;
+    /** The reason for failure */
+    reason;
+    constructor(message, options = {}) {
+        super(message, {
+            ...options,
+            docsPath: options.docsPath ?? '/docs/sdk/errors#transaction-failed',
+        });
+        this.transactionHash = options.transactionHash;
+        this.reason = options.reason;
+    }
+}
+/**
+ * Error thrown when a transaction reverts on-chain.
+ */
+export class TransactionRevertedError extends RadiusError {
+    name = 'TransactionRevertedError';
+    /** The transaction hash (if available) */
+    transactionHash;
+    /** The reason for failure */
+    reason;
+    /** The revert reason (decoded if available) */
+    revertReason;
+    /** The raw revert data */
+    revertData;
+    constructor(message, options = {}) {
+        super(message, {
+            ...options,
+            docsPath: options.docsPath ?? '/docs/sdk/errors#transaction-reverted',
+        });
+        this.transactionHash = options.transactionHash;
+        this.reason = options.reason;
+        this.revertReason = options.revertReason;
+        this.revertData = options.revertData;
+    }
+}
+/**
+ * Error thrown when gas estimation fails.
+ */
+export class GasEstimationError extends RadiusError {
+    name = 'GasEstimationError';
+    /** The address being called */
+    to;
+    /** The call data */
+    data;
+    constructor(message, options = {}) {
+        super(message, {
+            ...options,
+            docsPath: options.docsPath ?? '/docs/sdk/errors#gas-estimation',
+        });
+        this.to = options.to;
+        this.data = options.data;
+    }
+}
+/**
+ * Error thrown when transaction nonce is invalid.
+ */
+export class NonceError extends RadiusError {
+    name = 'NonceError';
+    /** The nonce that was used */
+    nonce;
+    /** The expected nonce */
+    expectedNonce;
+    constructor(message, options = {}) {
+        super(message, {
+            ...options,
+            docsPath: options.docsPath ?? '/docs/sdk/errors#nonce',
+        });
+        this.nonce = options.nonce;
+        this.expectedNonce = options.expectedNonce;
+    }
+}
+/**
+ * Error thrown when a transaction times out waiting for confirmation.
+ */
+export class TransactionTimeoutError extends RadiusError {
+    name = 'TransactionTimeoutError';
+    /** The transaction hash */
+    transactionHash;
+    /** How long we waited (in ms) */
+    timeout;
+    constructor(message, options = {}) {
+        super(message, {
+            ...options,
+            docsPath: options.docsPath ?? '/docs/sdk/errors#transaction-timeout',
+        });
+        this.transactionHash = options.transactionHash;
+        this.timeout = options.timeout;
+    }
+}
+/**
+ * Error thrown when one or more transactions in a batch fail.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await walletClient.sendTransactionBatch({ transactions });
+ * } catch (error) {
+ *   if (error instanceof BatchTransactionError) {
+ *     console.log('Batch failed:', error.message);
+ *     error.results.forEach((r, i) => {
+ *       if (r.error) {
+ *         console.log(`  Transaction ${i} failed: ${r.error}`);
+ *       } else {
+ *         console.log(`  Transaction ${i} succeeded: ${r.hash}`);
+ *       }
+ *     });
+ *   }
+ * }
+ * ```
+ */
+export class BatchTransactionError extends RadiusError {
+    name = 'BatchTransactionError';
+    /** Results for each transaction in the batch */
+    results;
+    constructor(message, results, options = {}) {
+        super(message, {
+            ...options,
+            docsPath: options.docsPath ?? '/docs/sdk/errors#batch-transaction',
+        });
+        this.results = results;
+    }
+}
+//# sourceMappingURL=transaction.js.map

package/src/_esm/errors/transaction.js.map

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