@prism-ing/wallet 0.1.0

package/dist/backends/zerodev-session-backend.d.ts

@@ -0,0 +1,43 @@
+import type { SessionKeyBackend } from '../types.js';
+import type { ZeroDevSessionBackendConfig } from './zerodev-types.js';
+/**
+ * Create a ZeroDev on-chain session key backend.
+ *
+ * @remarks
+ * The backend maps Prism session key policies to ZeroDev on-chain
+ * permission validators. The `config.registerOnChain` and
+ * `config.revokeOnChain` functions should be implemented by the consumer
+ * using `@zerodev/permissions`:
+ *
+ * @example
+ * ```ts
+ * import { toPermissionValidator, toECDSASigner } from '@zerodev/permissions';
+ * import { toCallPolicy, toTimestampPolicy, toGasPolicy } from '@zerodev/permissions/policies';
+ *
+ * const backend = createZeroDevSessionBackend({
+ *   registerOnChain: async (sessionAddress, policies) => {
+ *     const signer = await toECDSASigner({ signer: sessionPrivateKey });
+ *     const zerodevPolicies = policies.map(mapToZeroDevSdkPolicy);
+ *     const validator = await toPermissionValidator(client, {
+ *       signer,
+ *       policies: zerodevPolicies,
+ *       entryPoint: entryPoint07,
+ *       kernelVersion: '0.3.1',
+ *     });
+ *     // ... install validator, return tx hash
+ *     return txHash;
+ *   },
+ *   revokeOnChain: async (sessionAddress) => {
+ *     // ... remove validator, return tx hash
+ *     return txHash;
+ *   },
+ * });
+ *
+ * const manager = createSessionKeyManager(rootSigner, backend);
+ * ```
+ *
+ * @param config - ZeroDev backend configuration with registrar functions.
+ * @returns A {@link SessionKeyBackend} that enforces policies on-chain.
+ */
+export declare function createZeroDevSessionBackend(config: ZeroDevSessionBackendConfig): SessionKeyBackend;
+//# sourceMappingURL=zerodev-session-backend.d.ts.map

package/dist/backends/zerodev-session-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zerodev-session-backend.d.ts","sourceRoot":"","sources":["../../src/backends/zerodev-session-backend.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAoB,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEvE,OAAO,KAAK,EAAE,2BAA2B,EAAqB,MAAM,oBAAoB,CAAC;AAMzF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,2BAA2B,GAClC,iBAAiB,CA2BnB"}

package/dist/backends/zerodev-session-backend.js

@@ -0,0 +1,63 @@
+import { mapSessionPolicyToZeroDev } from './zerodev-policy-mapper.js';
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+/**
+ * Create a ZeroDev on-chain session key backend.
+ *
+ * @remarks
+ * The backend maps Prism session key policies to ZeroDev on-chain
+ * permission validators. The `config.registerOnChain` and
+ * `config.revokeOnChain` functions should be implemented by the consumer
+ * using `@zerodev/permissions`:
+ *
+ * @example
+ * ```ts
+ * import { toPermissionValidator, toECDSASigner } from '@zerodev/permissions';
+ * import { toCallPolicy, toTimestampPolicy, toGasPolicy } from '@zerodev/permissions/policies';
+ *
+ * const backend = createZeroDevSessionBackend({
+ *   registerOnChain: async (sessionAddress, policies) => {
+ *     const signer = await toECDSASigner({ signer: sessionPrivateKey });
+ *     const zerodevPolicies = policies.map(mapToZeroDevSdkPolicy);
+ *     const validator = await toPermissionValidator(client, {
+ *       signer,
+ *       policies: zerodevPolicies,
+ *       entryPoint: entryPoint07,
+ *       kernelVersion: '0.3.1',
+ *     });
+ *     // ... install validator, return tx hash
+ *     return txHash;
+ *   },
+ *   revokeOnChain: async (sessionAddress) => {
+ *     // ... remove validator, return tx hash
+ *     return txHash;
+ *   },
+ * });
+ *
+ * const manager = createSessionKeyManager(rootSigner, backend);
+ * ```
+ *
+ * @param config - ZeroDev backend configuration with registrar functions.
+ * @returns A {@link SessionKeyBackend} that enforces policies on-chain.
+ */
+export function createZeroDevSessionBackend(config) {
+    const backend = {
+        async registerSessionKey(sessionAddress, policy) {
+            const mapOptions = {};
+            if (config.defaultGasBudgetWei !== undefined) {
+                mapOptions.gasBudgetWei = config.defaultGasBudgetWei;
+            }
+            if (config.callPolicyVersion !== undefined) {
+                mapOptions.callPolicyVersion = config.callPolicyVersion;
+            }
+            const zeroDevPolicies = mapSessionPolicyToZeroDev(policy, mapOptions);
+            return config.registerOnChain(sessionAddress, zeroDevPolicies);
+        },
+        async revokeSessionKey(sessionAddress) {
+            return config.revokeOnChain(sessionAddress);
+        },
+    };
+    return backend;
+}
+//# sourceMappingURL=zerodev-session-backend.js.map

package/dist/backends/zerodev-session-backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zerodev-session-backend.js","sourceRoot":"","sources":["../../src/backends/zerodev-session-backend.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAGvE,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,MAAM,UAAU,2BAA2B,CACzC,MAAmC;IAEnC,MAAM,OAAO,GAAsB;QACjC,KAAK,CAAC,kBAAkB,CACtB,cAAuB,EACvB,MAAwB;YAExB,MAAM,UAAU,GAGZ,EAAE,CAAC;YACP,IAAI,MAAM,CAAC,mBAAmB,KAAK,SAAS,EAAE,CAAC;gBAC7C,UAAU,CAAC,YAAY,GAAG,MAAM,CAAC,mBAAmB,CAAC;YACvD,CAAC;YACD,IAAI,MAAM,CAAC,iBAAiB,KAAK,SAAS,EAAE,CAAC;gBAC3C,UAAU,CAAC,iBAAiB,GAAG,MAAM,CAAC,iBAAiB,CAAC;YAC1D,CAAC;YACD,MAAM,eAAe,GAAG,yBAAyB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;YAEtE,OAAO,MAAM,CAAC,eAAe,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC;QACjE,CAAC;QAED,KAAK,CAAC,gBAAgB,CAAC,cAAuB;YAC5C,OAAO,MAAM,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC;QAC9C,CAAC;KACF,CAAC;IAEF,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/backends/zerodev-types.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Types for the ZeroDev on-chain session key backend.
+ *
+ * @remarks
+ * These types model the ZeroDev Kernel v3 permission system:
+ * - Permission validators enforce policies at the smart contract level
+ * - Policies restrict what a session key can do (calls, gas, rate, time)
+ * - The backend maps Prism's {@link SessionKeyPolicy} to on-chain policies
+ *
+ * @packageDocumentation
+ */
+import type { Address } from '../result.js';
+/** Supported call policy versions from ZeroDev. */
+export type CallPolicyVersion = '0.0.1' | '0.0.2' | '0.0.3' | '0.0.4' | '0.0.5';
+/** Recommended production call policy version (Alchemy bundler compatible). */
+export declare const RECOMMENDED_CALL_POLICY_VERSION: CallPolicyVersion;
+/**
+ * Parameter condition for call policy argument restrictions.
+ *
+ * @remarks
+ * Maps 1:1 to ZeroDev's `ParamCondition` enum in `@zerodev/permissions`.
+ */
+export type ParamCondition = 'EQUAL' | 'GREATER_THAN' | 'LESS_THAN' | 'GREATER_THAN_OR_EQUAL' | 'LESS_THAN_OR_EQUAL' | 'NOT_EQUAL' | 'ONE_OF';
+/** Numeric values for on-chain encoding. */
+export declare const PARAM_CONDITION_VALUES: Record<ParamCondition, number>;
+/**
+ * A mapped on-chain policy ready for ZeroDev registration.
+ *
+ * @remarks
+ * Each policy has a type discriminator for exhaustive matching and
+ * the data payload needed for on-chain encoding.
+ */
+export type ZeroDevPolicy = ZeroDevTimestampPolicy | ZeroDevCallPolicy | ZeroDevGasPolicy | ZeroDevRateLimitPolicy | ZeroDevSudoPolicy;
+export interface ZeroDevTimestampPolicy {
+    readonly type: 'timestamp';
+    readonly validAfter: number;
+    readonly validUntil: number;
+}
+export interface ZeroDevCallPolicy {
+    readonly type: 'call';
+    readonly version: CallPolicyVersion;
+    readonly permissions: readonly ZeroDevCallPermission[];
+}
+export interface ZeroDevCallPermission {
+    readonly target: Address;
+    readonly functionSelector: string;
+    readonly valueLimit: bigint;
+    readonly args: readonly ZeroDevParamRule[];
+}
+export interface ZeroDevParamRule {
+    readonly condition: ParamCondition;
+    readonly offset: number;
+    readonly value: string;
+}
+export interface ZeroDevGasPolicy {
+    readonly type: 'gas';
+    readonly maxGasAllowedWei: bigint;
+}
+export interface ZeroDevRateLimitPolicy {
+    readonly type: 'rate_limit';
+    readonly count: number;
+    readonly interval: number;
+}
+export interface ZeroDevSudoPolicy {
+    readonly type: 'sudo';
+}
+/**
+ * Configuration for the ZeroDev session key backend.
+ *
+ * @remarks
+ * The `registrar` function is the integration point with ZeroDev's SDK.
+ * Consumers provide their own implementation that calls `@zerodev/permissions`
+ * functions (`toPermissionValidator`, `toCallPolicy`, etc.).
+ */
+export interface ZeroDevSessionBackendConfig {
+    /**
+     * Register policies on-chain. Returns a transaction hash.
+     *
+     * @remarks
+     * This function should:
+     * 1. Create an ECDSA signer via `toECDSASigner`
+     * 2. Map `ZeroDevPolicy[]` to ZeroDev policy objects
+     * 3. Call `toPermissionValidator` with the signer + policies
+     * 4. Install the permission via `toInitConfig` or enable mode
+     */
+    readonly registerOnChain: (sessionAddress: Address, policies: readonly ZeroDevPolicy[]) => Promise<string>;
+    /**
+     * Revoke a session key on-chain. Returns a transaction hash.
+     *
+     * @remarks
+     * Should remove the permission validator from the Kernel account.
+     */
+    readonly revokeOnChain: (sessionAddress: Address) => Promise<string>;
+    /**
+     * Default gas budget per session in wei.
+     * Defaults to 0.1 ETH (100000000000000000n) if not specified.
+     */
+    readonly defaultGasBudgetWei?: bigint;
+    /**
+     * Call policy version. Defaults to V0.0.4 (Alchemy bundler compatible).
+     */
+    readonly callPolicyVersion?: CallPolicyVersion;
+}
+//# sourceMappingURL=zerodev-types.d.ts.map

package/dist/backends/zerodev-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zerodev-types.d.ts","sourceRoot":"","sources":["../../src/backends/zerodev-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,mDAAmD;AACnD,MAAM,MAAM,iBAAiB,GACzB,OAAO,GACP,OAAO,GACP,OAAO,GACP,OAAO,GACP,OAAO,CAAC;AAEZ,+EAA+E;AAC/E,eAAO,MAAM,+BAA+B,EAAE,iBAA2B,CAAC;AAE1E;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GACtB,OAAO,GACP,cAAc,GACd,WAAW,GACX,uBAAuB,GACvB,oBAAoB,GACpB,WAAW,GACX,QAAQ,CAAC;AAEb,4CAA4C;AAC5C,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAQxD,CAAC;AAEX;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GACrB,sBAAsB,GACtB,iBAAiB,GACjB,gBAAgB,GAChB,sBAAsB,GACtB,iBAAiB,CAAC;AAEtB,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAE,SAAS,qBAAqB,EAAE,CAAC;CACxD;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAC5C;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;;;;;;;;OASG;IACH,QAAQ,CAAC,eAAe,EAAE,CACxB,cAAc,EAAE,OAAO,EACvB,QAAQ,EAAE,SAAS,aAAa,EAAE,KAC/B,OAAO,CAAC,MAAM,CAAC,CAAC;IAErB;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,EAAE,CACtB,cAAc,EAAE,OAAO,KACpB,OAAO,CAAC,MAAM,CAAC,CAAC;IAErB;;;OAGG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAEtC;;OAEG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;CAChD"}

package/dist/backends/zerodev-types.js

@@ -0,0 +1,13 @@
+/** Recommended production call policy version (Alchemy bundler compatible). */
+export const RECOMMENDED_CALL_POLICY_VERSION = '0.0.4';
+/** Numeric values for on-chain encoding. */
+export const PARAM_CONDITION_VALUES = {
+    EQUAL: 0,
+    GREATER_THAN: 1,
+    LESS_THAN: 2,
+    GREATER_THAN_OR_EQUAL: 3,
+    LESS_THAN_OR_EQUAL: 4,
+    NOT_EQUAL: 5,
+    ONE_OF: 6,
+};
+//# sourceMappingURL=zerodev-types.js.map

package/dist/backends/zerodev-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zerodev-types.js","sourceRoot":"","sources":["../../src/backends/zerodev-types.ts"],"names":[],"mappings":"AAqBA,+EAA+E;AAC/E,MAAM,CAAC,MAAM,+BAA+B,GAAsB,OAAO,CAAC;AAiB1E,4CAA4C;AAC5C,MAAM,CAAC,MAAM,sBAAsB,GAAmC;IACpE,KAAK,EAAE,CAAC;IACR,YAAY,EAAE,CAAC;IACf,SAAS,EAAE,CAAC;IACZ,qBAAqB,EAAE,CAAC;IACxB,kBAAkB,EAAE,CAAC;IACrB,SAAS,EAAE,CAAC;IACZ,MAAM,EAAE,CAAC;CACD,CAAC"}

package/dist/create-wallet.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Primary entry point for @prism-ing/wallet.
+ *
+ * @remarks
+ * {@link createWallet} is the factory function that initializes a complete
+ * wallet account with OWS signing, OneBalance accounts, and optional recovery.
+ *
+ * @example
+ * ```ts
+ * import { createWallet } from '@prism-ing/wallet';
+ *
+ * const wallet = await createWallet({
+ *   enclaveOptions: { preferHardware: true, appId: 'com.prism.app' },
+ *   oneBalanceApiKey: process.env.ONEBALANCE_API_KEY,
+ *   recovery: { evm: { guardians: [guardianAddr], threshold: 1 } },
+ * });
+ *
+ * if (!wallet.ok) {
+ *   console.error('Wallet creation failed:', wallet.error.code);
+ *   return;
+ * }
+ *
+ * const balance = await wallet.value.getBalance();
+ * ```
+ *
+ * @packageDocumentation
+ */
+import type { Result } from './result.js';
+import type { WalletAccount, WalletPendingRecovery, WalletConfig, RecoveryBackends } from './types.js';
+import type { WalletError } from './errors.js';
+import type { OWSAdapter, SigningBackend } from './signers/ows-adapter.js';
+import type { SecureEnclaveNativeBridge } from './signers/secure-enclave-types.js';
+import type { OneBalanceClient } from './internal/onebalance-client.js';
+/** Dependencies required by createWallet. Injected via factory. */
+export interface WalletDeps {
+    readonly createSigner: (config: WalletConfig) => Promise<Result<OWSAdapter, WalletError>>;
+    readonly oneBalanceClient: OneBalanceClient;
+    readonly recoveryBackends?: RecoveryBackends;
+    readonly signingBackend?: SigningBackend;
+}
+/**
+ * Create a fully initialized wallet account.
+ *
+ * @param config - Wallet configuration (validated via Zod).
+ * @param deps - Injectable dependencies (for testing).
+ * @returns A `Result` containing either a `WalletAccount` or a `WalletError`.
+ */
+export declare function createWallet(config: WalletConfig, deps: WalletDeps): Promise<Result<WalletAccount, WalletError>>;
+/**
+ * Create a wallet with production dependencies.
+ *
+ * @remarks
+ * This is the convenience wrapper that most consumers will use.
+ * For testing, use {@link createWallet} directly with mock deps.
+ *
+ * Wires:
+ * - iOS: Secure Enclave signing backend (when `nativeBridge` is provided and platform is iOS)
+ * - Node.js: OWS software signing backend (secp256k1 + ed25519)
+ * - OneBalance HTTP client for account abstraction + cross-chain
+ *
+ * @param config - Wallet configuration including OneBalance API key.
+ * @param options - Optional overrides for platform-specific backends.
+ * @returns A Result with the WalletAccount or a WalletError.
+ */
+export declare function createProductionWallet(config: WalletConfig, options?: ProductionWalletOptions): Promise<Result<WalletAccount | WalletPendingRecovery, WalletError>>;
+/** Options for {@link createProductionWallet}. */
+export interface ProductionWalletOptions {
+    /** iOS Secure Enclave native bridge. When provided on iOS, uses hardware-backed signing. */
+    readonly nativeBridge?: SecureEnclaveNativeBridge;
+    /** Custom key tag for the iOS Keychain. Defaults to `'prism-wallet-default'`. */
+    readonly keyTag?: string;
+    /** Custom biometric prompt text. Defaults to `'Authorize transaction'`. */
+    readonly biometricPrompt?: string;
+    /** Recovery backends for guardian-based signer rotation. */
+    readonly recoveryBackends?: RecoveryBackends;
+}
+/**
+ * Type guard: is this a wallet pending recovery setup?
+ *
+ * @param wallet - A wallet returned by {@link createProductionWallet}.
+ * @returns `true` if the wallet requires recovery setup before full activation.
+ */
+export declare function isPendingRecovery(wallet: WalletAccount | WalletPendingRecovery): wallet is WalletPendingRecovery;
+/**
+ * Wrap a WalletAccount in a WalletPendingRecovery that forces guardian setup.
+ * @internal — exported for test reuse only.
+ */
+export declare function createPendingRecoveryWrapper(wallet: WalletAccount): WalletPendingRecovery;
+//# sourceMappingURL=create-wallet.d.ts.map

package/dist/create-wallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-wallet.d.ts","sourceRoot":"","sources":["../src/create-wallet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,KAAK,EAAE,aAAa,EAAE,qBAAqB,EAAE,YAAY,EAAE,gBAAgB,EAA6B,MAAM,YAAY,CAAC;AAClI,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAI3E,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAGnF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAsBxE,mEAAmE;AACnE,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,YAAY,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC;IAC1F,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAC5C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IAC7C,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;CAC1C;AAMD;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC,CAyH7C;AAMD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,YAAY,EACpB,OAAO,CAAC,EAAE,uBAAuB,GAChC,OAAO,CAAC,MAAM,CAAC,aAAa,GAAG,qBAAqB,EAAE,WAAW,CAAC,CAAC,CAqCrE;AAED,kDAAkD;AAClD,MAAM,WAAW,uBAAuB;IACtC,4FAA4F;IAC5F,QAAQ,CAAC,YAAY,CAAC,EAAE,yBAAyB,CAAC;IAClD,iFAAiF;IACjF,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,2EAA2E;IAC3E,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,4DAA4D;IAC5D,QAAQ,CAAC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CAC9C;AAMD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,aAAa,GAAG,qBAAqB,GAC5C,MAAM,IAAI,qBAAqB,CAEjC;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,aAAa,GACpB,qBAAqB,CA2CvB"}

package/dist/create-wallet.js

@@ -0,0 +1,235 @@
+import { Ok, Err, fromPromise, toAddress } from './result.js';
+import { walletErrors } from './errors.js';
+import { WalletConfigSchema } from './schemas.js';
+import { createOWSAdapter } from './signers/ows-adapter.js';
+import { createOWSSigningBackend } from './signers/ows-signing-backend.js';
+import { createSecureEnclaveBackend } from './signers/secure-enclave-backend.js';
+import { detectPlatform } from './internal/platform.js';
+import { createOneBalanceHttpClient } from './internal/onebalance-http-client.js';
+import { createRecoveryManager } from './internal/recovery-manager.js';
+import { executeCrossChain } from './cross-chain.js';
+// ---------------------------------------------------------------------------
+// Module-level Constants
+// ---------------------------------------------------------------------------
+/** Maps OneBalance execution statuses to wallet TxStatus. */
+const EXECUTION_STATUS_MAP = {
+    PENDING: 'submitted',
+    EXECUTING: 'submitted',
+    COMPLETED: 'confirmed',
+    FAILED: 'failed',
+};
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+/**
+ * Create a fully initialized wallet account.
+ *
+ * @param config - Wallet configuration (validated via Zod).
+ * @param deps - Injectable dependencies (for testing).
+ * @returns A `Result` containing either a `WalletAccount` or a `WalletError`.
+ */
+export async function createWallet(config, deps) {
+    // 1. Parse and validate config at the boundary
+    const parsed = WalletConfigSchema.safeParse(config);
+    if (!parsed.success) {
+        const firstIssue = parsed.error.issues[0];
+        return Err(walletErrors.validation(firstIssue?.path.join('.') ?? 'unknown', firstIssue?.message ?? 'Invalid configuration'));
+    }
+    // 2. Create OWS signer
+    const signerResult = await deps.createSigner(config);
+    if (!signerResult.ok)
+        return signerResult;
+    const signer = signerResult.value;
+    // 3. Predict OneBalance smart account address
+    const accountType = config.accountType ?? 'kernel-v3.1-ecdsa';
+    const predictResult = await fromPromise(deps.oneBalanceClient.predictAddress({
+        type: accountType,
+        signerAddress: signer.evmAddress,
+    }), () => walletErrors.oneBalanceTimeout(5000));
+    if (!predictResult.ok)
+        return predictResult;
+    const predicted = predictResult.value;
+    const evmAddressResult = toAddress(predicted.predictedAddress);
+    if (!evmAddressResult.ok) {
+        return Err(walletErrors.validation('predictedAddress', 'Invalid address from OneBalance'));
+    }
+    const evmAddress = evmAddressResult.value;
+    // 4. Build the MultiAccount for OneBalance API calls
+    const accounts = [
+        {
+            type: accountType,
+            signerAddress: signer.evmAddress,
+            accountAddress: evmAddress,
+        },
+    ];
+    // 5. Build the WalletAccount
+    const walletAccount = {
+        signer,
+        evmAddress,
+        solanaAddress: signer.solanaAddress,
+        async getBalance() {
+            const balance = await deps.oneBalanceClient.getAggregatedBalance(accounts);
+            return {
+                totalUsd: balance.totalUsd,
+                breakdown: balance.breakdown.map((entry) => {
+                    // Parse CAIP-19 assetType (e.g. "eip155:8453/erc20:0x...") into chain info
+                    const chainPart = entry.assetType.split('/')[0] ?? entry.assetType;
+                    const chainIdStr = chainPart.split(':')[1] ?? '0';
+                    return {
+                        chainId: parseInt(chainIdStr, 10) || 0,
+                        chainName: chainPart,
+                        balanceUsd: entry.fiatValue,
+                        tokens: [{
+                                symbol: entry.assetType.split('/')[1]?.split(':')[0] ?? 'unknown',
+                                address: entry.assetType,
+                                amount: entry.amount,
+                                amountUsd: entry.fiatValue,
+                                decimals: 18,
+                            }],
+                    };
+                }),
+            };
+        },
+        async deposit(params) {
+            const result = await executeCrossChain(deps.oneBalanceClient, signer, {
+                fromAsset: `eip155:${params.chainId}/erc20:${params.token}`,
+                toAsset: `eip155:${params.chainId}/erc20:${params.token}`,
+                amount: params.amount.toString(),
+            }, accounts, deps.signingBackend !== undefined ? { backend: deps.signingBackend } : undefined);
+            if (!result.ok) {
+                return { txHash: '', status: 'failed' };
+            }
+            return {
+                txHash: result.value.quoteId,
+                status: 'submitted',
+            };
+        },
+        async getTransactionStatus(quoteId) {
+            const statusResult = await fromPromise(deps.oneBalanceClient.getExecutionStatus(quoteId), () => walletErrors.oneBalanceTimeout(5000));
+            if (!statusResult.ok) {
+                return { txHash: quoteId, status: 'failed' };
+            }
+            const raw = statusResult.value;
+            const mapped = EXECUTION_STATUS_MAP[raw.status];
+            return {
+                txHash: quoteId,
+                status: mapped ?? 'submitted',
+            };
+        },
+        recover() {
+            return createRecoveryManager(signer.evmAddress, signer.solanaAddress, deps.recoveryBackends ?? {});
+        },
+    };
+    return Ok(walletAccount);
+}
+// ---------------------------------------------------------------------------
+// Default Factory (production wiring)
+// ---------------------------------------------------------------------------
+/**
+ * Create a wallet with production dependencies.
+ *
+ * @remarks
+ * This is the convenience wrapper that most consumers will use.
+ * For testing, use {@link createWallet} directly with mock deps.
+ *
+ * Wires:
+ * - iOS: Secure Enclave signing backend (when `nativeBridge` is provided and platform is iOS)
+ * - Node.js: OWS software signing backend (secp256k1 + ed25519)
+ * - OneBalance HTTP client for account abstraction + cross-chain
+ *
+ * @param config - Wallet configuration including OneBalance API key.
+ * @param options - Optional overrides for platform-specific backends.
+ * @returns A Result with the WalletAccount or a WalletError.
+ */
+export async function createProductionWallet(config, options) {
+    const platform = detectPlatform();
+    const nativeBridge = options?.nativeBridge;
+    const signerFactory = () => {
+        if (platform === 'ios' && nativeBridge !== undefined) {
+            const enclaveConfig = {
+                nativeBridge,
+                ...(options?.keyTag !== undefined && { keyTag: options.keyTag }),
+                ...(options?.biometricPrompt !== undefined && { biometricPrompt: options.biometricPrompt }),
+            };
+            const backend = createSecureEnclaveBackend(enclaveConfig);
+            return createOWSAdapter(backend);
+        }
+        const backend = createOWSSigningBackend(config.signer);
+        return createOWSAdapter(backend);
+    };
+    const oneBalanceClient = createOneBalanceHttpClient({
+        apiKey: config.oneBalanceApiKey,
+    });
+    const deps = {
+        createSigner: signerFactory,
+        oneBalanceClient,
+        ...(options?.recoveryBackends !== undefined && { recoveryBackends: options.recoveryBackends }),
+    };
+    const walletResult = await createWallet(config, deps);
+    if (!walletResult.ok)
+        return walletResult;
+    // On iOS, wrap in WalletPendingRecovery to force guardian setup
+    if (platform === 'ios') {
+        return Ok(createPendingRecoveryWrapper(walletResult.value));
+    }
+    return walletResult;
+}
+// ---------------------------------------------------------------------------
+// Pending Recovery Wrapper (iOS only)
+// ---------------------------------------------------------------------------
+/**
+ * Type guard: is this a wallet pending recovery setup?
+ *
+ * @param wallet - A wallet returned by {@link createProductionWallet}.
+ * @returns `true` if the wallet requires recovery setup before full activation.
+ */
+export function isPendingRecovery(wallet) {
+    return 'activateWallet' in wallet;
+}
+/**
+ * Wrap a WalletAccount in a WalletPendingRecovery that forces guardian setup.
+ * @internal — exported for test reuse only.
+ */
+export function createPendingRecoveryWrapper(wallet) {
+    let guardianCount = 0;
+    const recoveryManager = wallet.recover();
+    const trackedRecovery = {
+        async setupPasskey() {
+            const result = await recoveryManager.setupPasskey();
+            guardianCount++;
+            return result;
+        },
+        async addDeviceGuardian(evmAddr, solAddr) {
+            await recoveryManager.addDeviceGuardian(evmAddr, solAddr);
+            guardianCount++;
+        },
+        async addContactGuardian(addr) {
+            await recoveryManager.addContactGuardian(addr);
+            guardianCount++;
+        },
+        initiateRecovery(newSigner) {
+            return recoveryManager.initiateRecovery(newSigner);
+        },
+    };
+    return {
+        signer: wallet.signer,
+        evmAddress: wallet.evmAddress,
+        solanaAddress: wallet.solanaAddress,
+        getBalance() {
+            return wallet.getBalance();
+        },
+        getTransactionStatus(quoteId) {
+            return wallet.getTransactionStatus(quoteId);
+        },
+        recover() {
+            return trackedRecovery;
+        },
+        activateWallet() {
+            if (guardianCount === 0) {
+                return Err(walletErrors.recoveryNotConfigured('ios'));
+            }
+            return Ok(wallet);
+        },
+    };
+}
+//# sourceMappingURL=create-wallet.js.map

package/dist/create-wallet.js.map

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

package/dist/cross-chain.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Cross-chain execution via OneBalance Resource Locks.
+ *
+ * @remarks
+ * Orchestrates the quote → sign → execute flow. Signs EVM operations
+ * via EIP-712 typed data and Solana operations via transaction signing.
+ * Resource Locks enable instant cross-chain execution — no waiting for
+ * source chain finality.
+ *
+ * @packageDocumentation
+ */
+import type { Result } from './result.js';
+import type { PrismSigner } from './types.js';
+import type { WalletError } from './errors.js';
+import type { SigningBackend } from './signers/ows-adapter.js';
+import type { OneBalanceClient } from './internal/onebalance-client.js';
+import type { QuoteRequest, ExecutionStatus } from './internal/onebalance-types.js';
+/** Parameters for requesting a cross-chain quote. */
+export interface CrossChainQuoteParams {
+    /** Source asset identifier (aggregated like "ob:usdc" or CAIP-19). */
+    readonly fromAsset: string;
+    /** Destination asset identifier. */
+    readonly toAsset: string;
+    /** Amount in smallest unit (as string). */
+    readonly amount: string;
+    /** Slippage tolerance in basis points (1-10000). */
+    readonly slippageTolerance?: number;
+    /** Optional recipient address in CAIP-10 format. */
+    readonly recipient?: string;
+    /**
+     * The wallet's smart account address for quote verification.
+     * When provided, verifies that EVM operation senders match this address.
+     */
+    readonly accountAddress?: string;
+    /**
+     * Skip client-side quote verification. Defaults to false.
+     * Set to true only for testing or when you handle verification externally.
+     */
+    readonly skipVerification?: boolean;
+}
+/** Result of a cross-chain execution. */
+export interface CrossChainResult {
+    readonly quoteId: string;
+    readonly status: ExecutionStatus;
+}
+/**
+ * Execute a cross-chain swap or transfer via OneBalance.
+ *
+ * @remarks
+ * Flow:
+ * 1. Get a quote from OneBalance (includes typed data to sign per chain operation)
+ * 2. Sign each operation — EVM via signTypedData, Solana via signTransaction
+ * 3. Submit the signed quote to OneBalance for execution via Resource Locks
+ *
+ * @param client - The OneBalance API client.
+ * @param signer - The PrismSigner for this wallet.
+ * @param params - Quote parameters (assets, amount, slippage).
+ * @param accounts - The MultiAccount array for this wallet.
+ * @returns A Result with the execution status or a WalletError.
+ */
+export declare function executeCrossChain(client: OneBalanceClient, signer: PrismSigner, params: CrossChainQuoteParams, accounts: QuoteRequest['from']['accounts'], options?: {
+    readonly backend?: SigningBackend;
+}): Promise<Result<CrossChainResult, WalletError>>;
+//# sourceMappingURL=cross-chain.d.ts.map

package/dist/cross-chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-chain.d.ts","sourceRoot":"","sources":["../src/cross-chain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,KAAK,EACV,YAAY,EAKZ,eAAe,EAChB,MAAM,gCAAgC,CAAC;AAQxC,qDAAqD;AACrD,MAAM,WAAW,qBAAqB;IACpC,sEAAsE;IACtE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,oCAAoC;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,2CAA2C;IAC3C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,oDAAoD;IACpD,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,oDAAoD;IACpD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CACrC;AAED,yCAAyC;AACzC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;CAClC;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,qBAAqB,EAC7B,QAAQ,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,EAC1C,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAA;CAAE,GAC9C,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,WAAW,CAAC,CAAC,CAoDhD"}