@azeth/sdk 0.2.0

package/dist/reputation/opinion.js

@@ -0,0 +1,198 @@
+import { encodeFunctionData, } from 'viem';
+import { ReputationModuleAbi, ERC8004ReputationRegistryAbi } from '@azeth/common/abis';
+import { AzethError, AZETH_CONTRACTS, ERC8004_REPUTATION_REGISTRY, } from '@azeth/common';
+import { requireAddress } from '../utils/addresses.js';
+import { wrapContractError } from '../utils/errors.js';
+/** Submit an opinion for an agent on the ERC-8004 Reputation Registry via the ReputationModule.
+ *
+ *  Routes the call through the smart account via ERC-4337 UserOperation so that
+ *  msg.sender in the ReputationModule context is the smart account (not the EOA).
+ *
+ *  The contract requires a positive net USD payment from the caller to the target agent
+ *  (aggregated on-chain via Chainlink). Value is int128 with configurable decimal precision.
+ *  If an opinion already exists for this rater→agent pair, it is updated (old entry revoked, new one created).
+ */
+export async function submitOpinion(publicClient, smartAccountClient, addresses, _account, opinion) {
+    if (opinion.agentId <= 0n) {
+        throw new AzethError('agentId must be a positive integer', 'INVALID_INPUT', { field: 'agentId' });
+    }
+    // Decimal-misuse detection: catch callers who pass e.g. value=85, decimals=18
+    // (effective value = 8.5e-17 — almost certainly a mistake, not intentional).
+    if (opinion.value !== 0n && opinion.valueDecimals > 0) {
+        const absValue = opinion.value < 0n ? -opinion.value : opinion.value;
+        const divisor = 10n ** BigInt(opinion.valueDecimals);
+        // If |value| < divisor, effectiveValue < 1.0 — likely decimal misuse
+        // (e.g., value=85, decimals=18 → effectiveValue = 0.0000000000000000085)
+        if (absValue > 0n && absValue < divisor) {
+            throw new AzethError(`Likely decimal misuse: value=${opinion.value} with valueDecimals=${opinion.valueDecimals} ` +
+                `yields an effective value near zero. For a rating of ${opinion.value}, use valueDecimals=0. ` +
+                `For WAD format, use value=${opinion.value}e18 with valueDecimals=18.`, 'INVALID_INPUT', { field: 'value', value: opinion.value.toString(), valueDecimals: opinion.valueDecimals });
+        }
+    }
+    const moduleAddress = requireAddress(addresses, 'reputationModule');
+    let txHash;
+    try {
+        // Route through smart account via UserOp so msg.sender = smart account address.
+        // The SmartAccountClient builds a UserOperation that wraps this call in
+        // AzethAccount.execute(mode, encodeSingle(module, 0, calldata)).
+        const data = encodeFunctionData({
+            abi: ReputationModuleAbi,
+            functionName: 'submitOpinion',
+            args: [
+                opinion.agentId,
+                opinion.value,
+                opinion.valueDecimals,
+                opinion.tag1,
+                opinion.tag2,
+                opinion.endpoint,
+                opinion.opinionURI,
+                opinion.opinionHash,
+            ],
+        });
+        txHash = await smartAccountClient.sendTransaction({
+            to: moduleAddress,
+            value: 0n,
+            data,
+        });
+    }
+    catch (err) {
+        throw wrapContractError(err, 'REGISTRY_ERROR');
+    }
+    return txHash;
+}
+/** Get payment-weighted reputation for an agent from the ReputationModule.
+ *
+ *  Calls ReputationModule.getWeightedReputation(agentId, raters[]).
+ *  Only raters with positive net USD payment to the agent contribute
+ *  to the weighted average.
+ */
+export async function getWeightedReputation(publicClient, addresses, agentId, raters) {
+    const moduleAddress = requireAddress(addresses, 'reputationModule');
+    try {
+        const result = await publicClient.readContract({
+            address: moduleAddress,
+            abi: ReputationModuleAbi,
+            functionName: 'getWeightedReputation',
+            args: [agentId, raters],
+        });
+        const [weightedValue, totalWeight, opinionCount] = result;
+        return { weightedValue, totalWeight, opinionCount };
+    }
+    catch (err) {
+        throw wrapContractError(err, 'REGISTRY_ERROR');
+    }
+}
+/** Get payment-weighted reputation for an agent across ALL raters.
+ *
+ *  WARNING: This calls the unbounded getWeightedReputationAll() on-chain function.
+ *  Gas cost grows linearly with the number of raters. Use getWeightedReputation()
+ *  with an explicit rater list for production workloads.
+ */
+export async function getWeightedReputationAll(publicClient, addresses, agentId) {
+    const moduleAddress = requireAddress(addresses, 'reputationModule');
+    try {
+        const result = await publicClient.readContract({
+            address: moduleAddress,
+            abi: ReputationModuleAbi,
+            functionName: 'getWeightedReputationAll',
+            args: [agentId],
+        });
+        const [weightedValue, totalWeight, opinionCount] = result;
+        return { weightedValue, totalWeight, opinionCount };
+    }
+    catch (err) {
+        throw wrapContractError(err, 'REGISTRY_ERROR');
+    }
+}
+/** Get the net payment delta between two accounts for a specific token.
+ *
+ *  Returns a signed int256: positive means `from` has paid `to` more than `to` has paid `from`.
+ *  Negative means `to` has paid `from` more.
+ */
+export async function getNetPaid(publicClient, addresses, from, to, token) {
+    const moduleAddress = requireAddress(addresses, 'reputationModule');
+    try {
+        const result = await publicClient.readContract({
+            address: moduleAddress,
+            abi: ReputationModuleAbi,
+            functionName: 'getNetPaid',
+            args: [from, to, token],
+        });
+        return result;
+    }
+    catch (err) {
+        throw wrapContractError(err, 'REGISTRY_ERROR');
+    }
+}
+/** Get the total net payment from `from` to `to` across all supported tokens, in 18-decimal USD.
+ *
+ *  Aggregates positive net deltas across all tokens tracked by the oracle (ETH, USDC, etc.)
+ *  and converts to a single USD value. Always returns >= 0 (only sums directions where
+ *  `from` has paid `to` more).
+ *
+ *  This is the same value the contract uses to gate opinion submissions ($1 minimum).
+ */
+export async function getTotalNetPaidUSD(publicClient, addresses, from, to) {
+    const moduleAddress = requireAddress(addresses, 'reputationModule');
+    try {
+        const result = await publicClient.readContract({
+            address: moduleAddress,
+            abi: ReputationModuleAbi,
+            functionName: 'getTotalNetPaidUSD',
+            args: [from, to],
+        });
+        return result;
+    }
+    catch (err) {
+        throw wrapContractError(err, 'REGISTRY_ERROR');
+    }
+}
+/** Get active opinion state for a rater→agent relationship.
+ *
+ *  Returns the current opinion index and whether an active opinion exists.
+ */
+export async function getActiveOpinion(publicClient, addresses, account, agentId) {
+    const moduleAddress = requireAddress(addresses, 'reputationModule');
+    try {
+        const result = await publicClient.readContract({
+            address: moduleAddress,
+            abi: ReputationModuleAbi,
+            functionName: 'getActiveOpinion',
+            args: [account, agentId],
+        });
+        const { opinionIndex, exists } = result;
+        return { opinionIndex, exists };
+    }
+    catch (err) {
+        throw wrapContractError(err, 'REGISTRY_ERROR');
+    }
+}
+/** Read a single opinion entry from the ERC-8004 Reputation Registry. */
+export async function readOpinion(publicClient, chainName, agentId, clientAddress, opinionIndex) {
+    const registryAddress = ERC8004_REPUTATION_REGISTRY[chainName];
+    if (!registryAddress) {
+        throw new AzethError(`No reputation registry configured for ${chainName}`, 'REGISTRY_ERROR');
+    }
+    try {
+        const result = await publicClient.readContract({
+            address: registryAddress,
+            abi: ERC8004ReputationRegistryAbi,
+            functionName: 'readFeedback',
+            args: [agentId, clientAddress, opinionIndex],
+        });
+        const [value, valueDecimals, tag1, tag2, isRevoked] = result;
+        return { value, valueDecimals, tag1, tag2, isRevoked };
+    }
+    catch (err) {
+        throw wrapContractError(err, 'REGISTRY_ERROR');
+    }
+}
+/** Get the Azeth ReputationModule address for a chain */
+export function getReputationModuleAddress(chainName) {
+    const addr = AZETH_CONTRACTS[chainName].reputationModule;
+    if (!addr || addr === '') {
+        throw new AzethError(`ReputationModule not deployed on ${chainName}`, 'NETWORK_ERROR', { chain: chainName });
+    }
+    return addr;
+}
+//# sourceMappingURL=opinion.js.map

package/dist/reputation/opinion.js.map

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

package/dist/utils/addresses.d.ts

@@ -0,0 +1,6 @@
+import { type SupportedChainName, type AzethContractAddresses } from '@azeth/common';
+/** Resolve contract addresses for a chain, with optional overrides */
+export declare function resolveAddresses(chainName: SupportedChainName, overrides?: Partial<AzethContractAddresses>): AzethContractAddresses;
+/** Validate that a required contract address is present, non-empty, and not the zero address */
+export declare function requireAddress(addresses: AzethContractAddresses, field: keyof AzethContractAddresses): `0x${string}`;
+//# sourceMappingURL=addresses.d.ts.map

package/dist/utils/addresses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"addresses.d.ts","sourceRoot":"","sources":["../../src/utils/addresses.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC5B,MAAM,eAAe,CAAC;AASvB,sEAAsE;AACtE,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,kBAAkB,EAC7B,SAAS,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,GAC1C,sBAAsB,CAyCxB;AAID,gGAAgG;AAChG,wBAAgB,cAAc,CAC5B,SAAS,EAAE,sBAAsB,EACjC,KAAK,EAAE,MAAM,sBAAsB,GAClC,KAAK,MAAM,EAAE,CAUf"}

package/dist/utils/addresses.js

@@ -0,0 +1,53 @@
+import { AZETH_CONTRACTS, AzethError, } from '@azeth/common';
+/** Validate an address override is well-formed if provided */
+function validateOverride(address, field) {
+    if (address !== undefined && !/^0x[0-9a-fA-F]{40}$/.test(address)) {
+        throw new AzethError(`Invalid override for ${field}: must be a valid Ethereum address`, 'INVALID_INPUT', { field });
+    }
+}
+/** Resolve contract addresses for a chain, with optional overrides */
+export function resolveAddresses(chainName, overrides) {
+    if (overrides) {
+        validateOverride(overrides.factory, 'factory');
+        validateOverride(overrides.guardianModule, 'guardianModule');
+        validateOverride(overrides.trustRegistryModule, 'trustRegistryModule');
+        validateOverride(overrides.paymentAgreementModule, 'paymentAgreementModule');
+        validateOverride(overrides.reputationModule, 'reputationModule');
+        validateOverride(overrides.priceOracle, 'priceOracle');
+        validateOverride(overrides.accountImplementation, 'accountImplementation');
+    }
+    const defaults = AZETH_CONTRACTS[chainName];
+    const resolved = {
+        factory: overrides?.factory ?? defaults.factory,
+        guardianModule: overrides?.guardianModule ?? defaults.guardianModule,
+        trustRegistryModule: overrides?.trustRegistryModule ?? defaults.trustRegistryModule,
+        paymentAgreementModule: overrides?.paymentAgreementModule ?? defaults.paymentAgreementModule,
+        reputationModule: overrides?.reputationModule ?? defaults.reputationModule,
+        priceOracle: overrides?.priceOracle ?? defaults.priceOracle,
+        accountImplementation: overrides?.accountImplementation ?? defaults.accountImplementation,
+    };
+    // HIGH-8 fix: Validate that no required address is empty. Empty addresses (like Base
+    // mainnet before deployment) would pass to viem and cause confusing errors or send
+    // transactions to the zero address.
+    // priceOracle and accountImplementation are optional (only needed for createAccount).
+    const REQUIRED_FIELDS = [
+        'factory', 'guardianModule', 'trustRegistryModule', 'paymentAgreementModule', 'reputationModule',
+    ];
+    for (const key of REQUIRED_FIELDS) {
+        const value = resolved[key];
+        if (!value || value === '' || value === '0x') {
+            throw new AzethError(`Contract ${key} not yet deployed on ${chainName}. Run deployment first or provide an override.`, 'INVALID_INPUT', { field: key, chain: chainName });
+        }
+    }
+    return resolved;
+}
+const ZERO_ADDRESS = '0x0000000000000000000000000000000000000000';
+/** Validate that a required contract address is present, non-empty, and not the zero address */
+export function requireAddress(addresses, field) {
+    const addr = addresses[field];
+    if (!addr || addr === '' || addr === ZERO_ADDRESS) {
+        throw new AzethError(`${field} address not configured`, 'NETWORK_ERROR', { field });
+    }
+    return addr;
+}
+//# sourceMappingURL=addresses.js.map

package/dist/utils/addresses.js.map

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

package/dist/utils/errors.d.ts

@@ -0,0 +1,23 @@
+import { AzethError, type AzethErrorCode } from '@azeth/common';
+/** Attempt to decode a Solidity custom error from a thrown error object.
+ *
+ *  Tries each Azeth contract ABI in sequence until one successfully decodes
+ *  the revert data. Returns the mapped AzethErrorCode and a human-readable
+ *  message, or undefined if the error is not a recognized contract revert.
+ */
+export declare function decodeContractError(err: unknown): {
+    code: AzethErrorCode;
+    message: string;
+} | undefined;
+/** Wrap an unknown error, attempting contract error decoding first.
+ *
+ *  Drop-in replacement for the existing catch-block pattern:
+ *    catch (err) { throw wrapContractError(err, 'NETWORK_ERROR'); }
+ *
+ *  If the error is already an AzethError, re-throws it unchanged.
+ *  If the error contains revert data matching a known contract error,
+ *  throws an AzethError with the specific code and message.
+ *  Otherwise, throws an AzethError with the provided fallback code.
+ */
+export declare function wrapContractError(err: unknown, fallbackCode: AzethErrorCode): AzethError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AACA,OAAO,EACL,UAAU,EACV,KAAK,cAAc,EACpB,MAAM,eAAe,CAAC;AA2JvB;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAsBvG;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,EAAE,YAAY,EAAE,cAAc,GAAG,UAAU,CA6BxF"}

package/dist/utils/errors.js

@@ -0,0 +1,188 @@
+import { decodeErrorResult } from 'viem';
+import { AzethError, } from '@azeth/common';
+import { AzethAccountAbi, AzethFactoryAbi, GuardianModuleAbi, TrustRegistryModuleAbi, PaymentAgreementModuleAbi, ReputationModuleAbi, } from '@azeth/common/abis';
+/** All Azeth contract ABIs for error decoding */
+const ALL_ABIS = [
+    AzethAccountAbi,
+    AzethFactoryAbi,
+    GuardianModuleAbi,
+    TrustRegistryModuleAbi,
+    PaymentAgreementModuleAbi,
+    ReputationModuleAbi,
+];
+/** Mapping from contract error name → AzethErrorCode + human-readable message */
+const ERROR_MAP = {
+    // AzethFactory
+    AccountAlreadyDeployed: { code: 'ACCOUNT_EXISTS', message: 'An account with this salt already exists.' },
+    MaxAccountsPerOwnerReached: { code: 'INVALID_INPUT', message: 'Maximum accounts per owner reached (100).' },
+    DeploymentFailed: { code: 'CONTRACT_ERROR', message: 'Smart account deployment failed.' },
+    FailedDeployment: { code: 'CONTRACT_ERROR', message: 'Contract deployment failed.' },
+    Create2EmptyBytecode: { code: 'CONTRACT_ERROR', message: 'Deployment bytecode is empty.' },
+    // GuardianModule
+    GuardianLimitExceeded: { code: 'BUDGET_EXCEEDED', message: 'Transaction exceeds guardian spending limit.' },
+    ExecutorSpendExceedsLimit: { code: 'BUDGET_EXCEEDED', message: 'Executor spending exceeds daily limit.' },
+    TokenNotWhitelisted: { code: 'GUARDIAN_REJECTED', message: 'Token is not on the guardian whitelist.' },
+    NotGuardian: { code: 'UNAUTHORIZED', message: 'Caller is not the authorized guardian.' },
+    NotTightening: { code: 'GUARDIAN_REJECTED', message: 'Guardrail changes must tighten limits (loosening requires timelock).' },
+    TimelockNotExpired: { code: 'GUARDIAN_REJECTED', message: 'Timelock period has not expired yet.' },
+    ChangeAlreadyPending: { code: 'GUARDIAN_REJECTED', message: 'A guardrail change is already pending.' },
+    NoPendingChange: { code: 'GUARDIAN_REJECTED', message: 'No pending guardrail change to execute.' },
+    NoPendingEmergency: { code: 'GUARDIAN_REJECTED', message: 'No pending emergency withdrawal to execute.' },
+    InvalidGuardrails: { code: 'INVALID_INPUT', message: 'Invalid guardrails configuration.' },
+    // AzethAccount
+    OnlyEntryPoint: { code: 'UNAUTHORIZED', message: 'Only the ERC-4337 EntryPoint can call this function.' },
+    OnlyOwner: { code: 'UNAUTHORIZED', message: 'Only the account owner can call this function.' },
+    OnlyExecutor: { code: 'UNAUTHORIZED', message: 'Only an installed executor module can call this function.' },
+    OnlyFactory: { code: 'UNAUTHORIZED', message: 'Only the factory can call this function.' },
+    NotAuthorized: { code: 'UNAUTHORIZED', message: 'Caller is not authorized for this operation.' },
+    ExecutionFailed: { code: 'CONTRACT_ERROR', message: 'Account execution failed.' },
+    ModuleAlreadyInstalled: { code: 'INVALID_INPUT', message: 'Module is already installed on this account.' },
+    ModuleNotInstalled: { code: 'INVALID_INPUT', message: 'Module is not installed on this account.' },
+    UnsupportedCallType: { code: 'INVALID_INPUT', message: 'Unsupported call type for this execution mode.' },
+    UnsupportedExecType: { code: 'INVALID_INPUT', message: 'Unsupported execution type.' },
+    UnsupportedModuleType: { code: 'INVALID_INPUT', message: 'Unsupported module type.' },
+    MismatchModuleTypeId: { code: 'INVALID_INPUT', message: 'Module type ID does not match expected type.' },
+    MaxHooksReached: { code: 'INVALID_INPUT', message: 'Maximum number of hooks reached.' },
+    NotSmartAccount: { code: 'UNAUTHORIZED', message: 'Target is not a smart account.' },
+    BatchLengthMismatch: { code: 'INVALID_INPUT', message: 'Batch execution arrays have mismatched lengths.' },
+    // TrustRegistryModule
+    AlreadyRegistered: { code: 'ACCOUNT_EXISTS', message: 'This account is already registered on the trust registry.' },
+    AlreadyInitialized: { code: 'INVALID_INPUT', message: 'Module is already initialized.' },
+    NotInitialized: { code: 'ACCOUNT_NOT_FOUND', message: 'Account is not initialized on this module.' },
+    NotRegistered: { code: 'SERVICE_NOT_FOUND', message: 'Account is not registered on the trust registry.' },
+    InvalidAddress: { code: 'INVALID_INPUT', message: 'Invalid address provided.' },
+    InvalidURI: { code: 'INVALID_INPUT', message: 'Invalid URI provided.' },
+    InvalidOwner: { code: 'UNAUTHORIZED', message: 'Invalid owner for this operation.' },
+    // ReputationModule
+    NotAzethAccount: { code: 'UNAUTHORIZED', message: 'Caller is not a registered Azeth smart account.' },
+    InsufficientPaymentUSD: { code: 'INSUFFICIENT_PAYMENT', message: 'You must pay the agent at least $1 USD before submitting an opinion.' },
+    SelfRatingNotAllowed: { code: 'INVALID_INPUT', message: 'Cannot rate yourself.' },
+    SiblingRatingNotAllowed: { code: 'INVALID_INPUT', message: 'Cannot rate a sibling account (same owner).' },
+    InvalidAgentId: { code: 'INVALID_INPUT', message: 'Invalid agent token ID.' },
+    InvalidValueDecimals: { code: 'INVALID_INPUT', message: 'Value decimals exceed maximum (18).' },
+    // PaymentAgreementModule
+    AgreementNotExists: { code: 'AGREEMENT_NOT_FOUND', message: 'Payment agreement does not exist.' },
+    InvalidAgreement: { code: 'INVALID_INPUT', message: 'Invalid payment agreement parameters.' },
+    SelfAgreement: { code: 'INVALID_INPUT', message: 'Cannot create a payment agreement with yourself.' },
+    InsufficientBalance: { code: 'INSUFFICIENT_BALANCE', message: 'Insufficient balance for this operation.' },
+    TransferFailed: { code: 'PAYMENT_FAILED', message: 'Token transfer failed.' },
+};
+/** Extract revert data hex from a viem error object using multiple strategies.
+ *
+ *  Viem wraps contract reverts in nested error objects with inconsistent
+ *  structures across versions and RPC providers. This function cascades
+ *  through every known location where revert data can appear.
+ */
+function extractRevertData(err) {
+    if (!(err instanceof Error))
+        return undefined;
+    const viemErr = err;
+    // Strategy 1: Direct .data property
+    if (typeof viemErr.data === 'string' && viemErr.data.startsWith('0x') && viemErr.data.length >= 10) {
+        return viemErr.data;
+    }
+    if (viemErr.data && typeof viemErr.data === 'object' && typeof viemErr.data.data === 'string') {
+        if (viemErr.data.data.startsWith('0x') && viemErr.data.data.length >= 10) {
+            return viemErr.data.data;
+        }
+    }
+    // Strategy 2: .cause chain (viem wraps errors 1-2 levels deep)
+    if (viemErr.cause) {
+        if (typeof viemErr.cause.data === 'string' && viemErr.cause.data.startsWith('0x') && viemErr.cause.data.length >= 10) {
+            return viemErr.cause.data;
+        }
+        if (viemErr.cause.data && typeof viemErr.cause.data === 'object' && typeof viemErr.cause.data.data === 'string') {
+            if (viemErr.cause.data.data.startsWith('0x') && viemErr.cause.data.data.length >= 10) {
+                return viemErr.cause.data.data;
+            }
+        }
+        // Third level
+        if (viemErr.cause.cause) {
+            if (typeof viemErr.cause.cause.data === 'string' && viemErr.cause.cause.data.startsWith('0x') && viemErr.cause.cause.data.length >= 10) {
+                return viemErr.cause.cause.data;
+            }
+            if (viemErr.cause.cause.data && typeof viemErr.cause.cause.data === 'object' && typeof viemErr.cause.cause.data.data === 'string') {
+                if (viemErr.cause.cause.data.data.startsWith('0x') && viemErr.cause.cause.data.data.length >= 10) {
+                    return viemErr.cause.cause.data.data;
+                }
+            }
+        }
+    }
+    // Strategy 3: viem's .walk() method (available on BaseError)
+    if (typeof viemErr.walk === 'function') {
+        const found = viemErr.walk((e) => {
+            const inner = e;
+            return typeof inner.data === 'string' && inner.data.startsWith('0x') && inner.data.length >= 10;
+        });
+        if (found && typeof found.data === 'string' && found.data.startsWith('0x')) {
+            return found.data;
+        }
+    }
+    // Strategy 4: Parse hex from error message (bundler errors embed revert data in text)
+    const msg = viemErr.message;
+    const hexMatch = msg.match(/(?:revert(?:ed)?|data|reason|error).*?(0x[0-9a-fA-F]{8,})/i);
+    if (hexMatch?.[1] && hexMatch[1].length >= 10) {
+        return hexMatch[1];
+    }
+    return undefined;
+}
+/** Attempt to decode a Solidity custom error from a thrown error object.
+ *
+ *  Tries each Azeth contract ABI in sequence until one successfully decodes
+ *  the revert data. Returns the mapped AzethErrorCode and a human-readable
+ *  message, or undefined if the error is not a recognized contract revert.
+ */
+export function decodeContractError(err) {
+    const data = extractRevertData(err);
+    if (!data)
+        return undefined;
+    for (const abi of ALL_ABIS) {
+        try {
+            const decoded = decodeErrorResult({ abi, data });
+            const mapping = ERROR_MAP[decoded.errorName];
+            if (mapping) {
+                return mapping;
+            }
+            // Known error name but not in our map — return a generic decoded message
+            return {
+                code: 'CONTRACT_ERROR',
+                message: `Contract error: ${decoded.errorName}`,
+            };
+        }
+        catch {
+            // This ABI doesn't match this selector — try next
+        }
+    }
+    return undefined;
+}
+/** Wrap an unknown error, attempting contract error decoding first.
+ *
+ *  Drop-in replacement for the existing catch-block pattern:
+ *    catch (err) { throw wrapContractError(err, 'NETWORK_ERROR'); }
+ *
+ *  If the error is already an AzethError, re-throws it unchanged.
+ *  If the error contains revert data matching a known contract error,
+ *  throws an AzethError with the specific code and message.
+ *  Otherwise, throws an AzethError with the provided fallback code.
+ */
+export function wrapContractError(err, fallbackCode) {
+    if (err instanceof AzethError)
+        return err;
+    const decoded = decodeContractError(err);
+    if (decoded) {
+        return new AzethError(decoded.message, decoded.code, {
+            originalError: err instanceof Error ? err.name : undefined,
+        });
+    }
+    // Detect ERC-4337 AA error codes (AA21, AA23, AA24, AA25, etc.)
+    const message = err instanceof Error ? err.message : String(err);
+    const aaMatch = message.match(/AA(\d{2})/);
+    if (aaMatch) {
+        return new AzethError(message, 'CONTRACT_ERROR', {
+            aaErrorCode: `AA${aaMatch[1]}`,
+            originalError: err instanceof Error ? err.name : undefined,
+        });
+    }
+    return new AzethError(err instanceof Error ? err.message : 'Unknown error', fallbackCode, { originalError: err instanceof Error ? err.name : undefined });
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

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

package/dist/utils/execution.d.ts

@@ -0,0 +1,20 @@
+import { type Hex } from 'viem';
+/** ModeCode for CALLTYPE_SINGLE (0x00) + EXECTYPE_DEFAULT (0x00) + padding.
+ *  Layout: [1 byte callType][1 byte execType][4 bytes unused][4 bytes context][22 bytes payload]
+ *  Matches ModeLib.encodeSimpleSingle() in Solidity. */
+export declare function encodeSimpleSingle(): Hex;
+/** ModeCode for CALLTYPE_BATCH (0x01) + EXECTYPE_DEFAULT (0x00) + padding.
+ *  Matches ModeLib.encodeSimpleBatch() in Solidity. */
+export declare function encodeSimpleBatch(): Hex;
+/** Encode a single execution target: abi.encodePacked(target, value, callData).
+ *  Matches ExecutionLib.encodeSingle() in Solidity. */
+export declare function encodeSingleExecution(target: `0x${string}`, value: bigint, callData: Hex): Hex;
+/** Encode batch execution: abi.encode(Execution[]).
+ *  Matches ExecutionLib.decodeBatch() expectation in Solidity.
+ *  Execution is (address target, uint256 value, bytes callData). */
+export declare function encodeBatchExecution(calls: Array<{
+    target: `0x${string}`;
+    value: bigint;
+    data: Hex;
+}>): Hex;
+//# sourceMappingURL=execution.d.ts.map

package/dist/utils/execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution.d.ts","sourceRoot":"","sources":["../../src/utils/execution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqC,KAAK,GAAG,EAAE,MAAM,MAAM,CAAC;AAEnE;;wDAEwD;AACxD,wBAAgB,kBAAkB,IAAI,GAAG,CAExC;AAED;uDACuD;AACvD,wBAAgB,iBAAiB,IAAI,GAAG,CAEvC;AAED;uDACuD;AACvD,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,KAAK,MAAM,EAAE,EACrB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,GAAG,GACZ,GAAG,CAKL;AAED;;oEAEoE;AACpE,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,KAAK,CAAC;IAAE,MAAM,EAAE,KAAK,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,GAAG,CAAA;CAAE,CAAC,GAChE,GAAG,CASL"}

package/dist/utils/execution.js

@@ -0,0 +1,28 @@
+import { encodeAbiParameters, encodePacked } from 'viem';
+/** ModeCode for CALLTYPE_SINGLE (0x00) + EXECTYPE_DEFAULT (0x00) + padding.
+ *  Layout: [1 byte callType][1 byte execType][4 bytes unused][4 bytes context][22 bytes payload]
+ *  Matches ModeLib.encodeSimpleSingle() in Solidity. */
+export function encodeSimpleSingle() {
+    return '0x0000000000000000000000000000000000000000000000000000000000000000';
+}
+/** ModeCode for CALLTYPE_BATCH (0x01) + EXECTYPE_DEFAULT (0x00) + padding.
+ *  Matches ModeLib.encodeSimpleBatch() in Solidity. */
+export function encodeSimpleBatch() {
+    return '0x0100000000000000000000000000000000000000000000000000000000000000';
+}
+/** Encode a single execution target: abi.encodePacked(target, value, callData).
+ *  Matches ExecutionLib.encodeSingle() in Solidity. */
+export function encodeSingleExecution(target, value, callData) {
+    return encodePacked(['address', 'uint256', 'bytes'], [target, value, callData]);
+}
+/** Encode batch execution: abi.encode(Execution[]).
+ *  Matches ExecutionLib.decodeBatch() expectation in Solidity.
+ *  Execution is (address target, uint256 value, bytes callData). */
+export function encodeBatchExecution(calls) {
+    return encodeAbiParameters([{ type: 'tuple[]', components: [
+                { name: 'target', type: 'address' },
+                { name: 'value', type: 'uint256' },
+                { name: 'callData', type: 'bytes' },
+            ] }], [calls.map(c => ({ target: c.target, value: c.value, callData: c.data }))]);
+}
+//# sourceMappingURL=execution.js.map

package/dist/utils/execution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution.js","sourceRoot":"","sources":["../../src/utils/execution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAY,MAAM,MAAM,CAAC;AAEnE;;wDAEwD;AACxD,MAAM,UAAU,kBAAkB;IAChC,OAAO,oEAAoE,CAAC;AAC9E,CAAC;AAED;uDACuD;AACvD,MAAM,UAAU,iBAAiB;IAC/B,OAAO,oEAAoE,CAAC;AAC9E,CAAC;AAED;uDACuD;AACvD,MAAM,UAAU,qBAAqB,CACnC,MAAqB,EACrB,KAAa,EACb,QAAa;IAEb,OAAO,YAAY,CACjB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,EAC/B,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,CAC1B,CAAC;AACJ,CAAC;AAED;;oEAEoE;AACpE,MAAM,UAAU,oBAAoB,CAClC,KAAiE;IAEjE,OAAO,mBAAmB,CACxB,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE;gBAC9B,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE;gBACnC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;gBAClC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE;aACpC,EAAC,CAAC,EACH,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAC3E,CAAC;AACJ,CAAC"}

package/dist/utils/paymaster.d.ts

@@ -0,0 +1,35 @@
+import type { GetPaymasterDataParameters, GetPaymasterDataReturnType, GetPaymasterStubDataParameters, GetPaymasterStubDataReturnType } from 'viem/account-abstraction';
+/** Client-side sponsorship policy configuration.
+ *  Defense-in-depth layer on top of the paymaster's own server-side policies.
+ *  All checks are enforced before calling the paymaster RPC. */
+export interface PaymasterPolicy {
+    /** Only sponsor UserOps from these smart account addresses.
+     *  When empty/undefined, sponsors all accounts. */
+    allowedAccounts?: `0x${string}`[];
+    /** Maximum number of sponsored UserOps per account per day (anti-Sybil).
+     *  0 or undefined = no limit. */
+    maxSponsoredPerDay?: number;
+    /** Maximum gas cost (in wei) to sponsor per UserOp.
+     *  UserOps exceeding this cost fall back to self-paid. */
+    maxGasCostWei?: bigint;
+}
+/** Paymaster middleware shape expected by createSmartAccountClient */
+export interface PaymasterMiddleware {
+    getPaymasterData: (parameters: GetPaymasterDataParameters) => Promise<GetPaymasterDataReturnType>;
+    getPaymasterStubData: (parameters: GetPaymasterStubDataParameters) => Promise<GetPaymasterStubDataReturnType>;
+}
+/** Check if the policy allows sponsoring this UserOp.
+ *  Returns a reason string if denied, undefined if allowed. */
+export declare function checkPolicy(policy: PaymasterPolicy | undefined, params: GetPaymasterDataParameters): string | undefined;
+/** Create a paymaster middleware that wraps a PimlicoClient with graceful fallback
+ *  and optional policy enforcement.
+ *
+ *  When the paymaster is unreachable or rejects the UserOp, the middleware returns
+ *  empty paymaster data so the UserOp falls back to self-paid gas.
+ *
+ *  @param paymasterUrl - URL for the paymaster RPC endpoint
+ *  @param policy - Optional sponsorship policy for client-side filtering
+ *  @returns PaymasterMiddleware compatible with permissionless's createSmartAccountClient
+ */
+export declare function createPaymasterMiddleware(paymasterUrl: string, policy?: PaymasterPolicy): PaymasterMiddleware;
+//# sourceMappingURL=paymaster.d.ts.map

package/dist/utils/paymaster.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paymaster.d.ts","sourceRoot":"","sources":["../../src/utils/paymaster.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,0BAA0B,EAAE,0BAA0B,EAAE,8BAA8B,EAAE,8BAA8B,EAAE,MAAM,0BAA0B,CAAC;AAEvK;;gEAEgE;AAChE,MAAM,WAAW,eAAe;IAC9B;uDACmD;IACnD,eAAe,CAAC,EAAE,KAAK,MAAM,EAAE,EAAE,CAAC;IAClC;qCACiC;IACjC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;8DAC0D;IAC1D,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,sEAAsE;AACtE,MAAM,WAAW,mBAAmB;IAClC,gBAAgB,EAAE,CAAC,UAAU,EAAE,0BAA0B,KAAK,OAAO,CAAC,0BAA0B,CAAC,CAAC;IAClG,oBAAoB,EAAE,CAAC,UAAU,EAAE,8BAA8B,KAAK,OAAO,CAAC,8BAA8B,CAAC,CAAC;CAC/G;AAsCD;+DAC+D;AAC/D,wBAAgB,WAAW,CACzB,MAAM,EAAE,eAAe,GAAG,SAAS,EACnC,MAAM,EAAE,0BAA0B,GACjC,MAAM,GAAG,SAAS,CAgCpB;AAED;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,MAAM,EACpB,MAAM,CAAC,EAAE,eAAe,GACvB,mBAAmB,CAwCrB"}