@aspect-wallet/sdk 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,366 @@
+/**
+ * Core type definitions for the FcxWallet SDK.
+ * Corresponds to SPEC-013 Section 18.
+ */
+export type Hex = `0x${string}`;
+export type Address = `0x${string}`;
+export type ChainId = 'arbitrum-one' | 'arbitrum-sepolia' | 'base' | 'base-sepolia' | 'polygon' | 'polygon-amoy' | 'ethereum' | 'sepolia';
+export interface UserOperation {
+    sender: Address;
+    nonce: bigint;
+    initCode: Hex;
+    callData: Hex;
+    callGasLimit: bigint;
+    verificationGasLimit: bigint;
+    preVerificationGas: bigint;
+    maxFeePerGas: bigint;
+    maxPriorityFeePerGas: bigint;
+    paymasterAndData: Hex;
+    signature: Hex;
+}
+export interface ExecutionResult {
+    userOpHash: Hex;
+    transactionHash: Hex;
+    success: boolean;
+    actualGasCost: bigint;
+    actualGasUsed: bigint;
+    blockNumber: bigint;
+    timestamp: number;
+}
+export interface CallRequest {
+    target: Address;
+    value: bigint;
+    data: Hex;
+}
+export interface ExecuteOptions extends CallRequest {
+    sponsored?: boolean;
+    authTier?: 1 | 2 | 3 | 4;
+}
+export interface BatchExecuteOptions {
+    calls: CallRequest[];
+    sponsored?: boolean;
+    authTier?: 1 | 2 | 3 | 4;
+}
+export interface SessionInfo {
+    jwt: string;
+    user: {
+        id: string;
+        email?: string;
+        oauthProvider?: string;
+    };
+    wallet: {
+        address: Address;
+        deployed: boolean;
+    };
+    signer: {
+        address: Address;
+        type: 'turnkey' | 'passkey';
+    };
+    expiresAt: number;
+}
+export interface WalletInfo {
+    address: Address;
+    deployed: boolean;
+    chain: ChainId;
+    factory: Address;
+    salt: Hex;
+}
+export interface WalletState {
+    address: Address;
+    deployed: boolean;
+    owner: Address;
+    balance: bigint;
+    entryPointDeposit: bigint;
+    nonce: {
+        key: bigint;
+        sequence: bigint;
+    };
+    modules: ModuleInfo[];
+    frozen: boolean;
+}
+export interface ModuleInfo {
+    moduleId: number;
+    type: 'SingleSigner' | 'SessionKey' | 'WebAuthn' | 'DeviceGuardian' | 'MultiSig';
+    signer: Address;
+    installedAt: number;
+    expiresAt?: number;
+    hooks?: HookInfo[];
+}
+export interface HookInfo {
+    type: 'Allowlist' | 'SpendLimit' | 'TimeRange' | 'PaymasterGuard';
+    config: AllowlistConfig | SpendLimitConfig | TimeRangeConfig | PaymasterGuardConfig;
+}
+export interface AllowlistConfig {
+    entries: Array<{
+        target: Address;
+        selector: Hex;
+    }>;
+}
+export interface SpendLimitConfig {
+    maxPerTx: bigint;
+    maxCumulative: bigint;
+    spent: bigint;
+}
+export interface TimeRangeConfig {
+    validAfter: number;
+    validUntil: number;
+}
+export interface PaymasterGuardConfig {
+    requiredPaymaster: Address;
+}
+export interface SessionKeyPermissions {
+    allowlist: Array<{
+        target: Address;
+        selector: Hex;
+    }>;
+    spendLimit: {
+        perTx: bigint;
+        cumulative: bigint;
+    };
+    timeRange: {
+        validAfter: number;
+        validUntil: number;
+    };
+    requiredPaymaster?: Address;
+}
+export interface SessionKeyInfo {
+    moduleId: number;
+    address: Address;
+    expiresAt: number;
+    permissions: SessionKeyPermissions;
+}
+export interface SessionKeyStatus {
+    active: boolean;
+    remainingTime: number;
+    remainingSpend: bigint;
+    usageCount: number;
+}
+export interface PaymasterApproval {
+    paymasterAndData: Hex;
+    validUntil: number;
+    validAfter: number;
+    estimatedCost: bigint;
+}
+export interface SponsorshipBudget {
+    daily: {
+        limit: bigint;
+        used: bigint;
+        remaining: bigint;
+    };
+    perUser: {
+        limit: bigint;
+        used: bigint;
+        remaining: bigint;
+    };
+}
+export interface SponsorshipPolicy {
+    allowedTargets: Address[];
+    allowedSelectors: Hex[];
+    blockedTargets: Address[];
+    perUserLimit: {
+        maxGasPerDay: bigint;
+    };
+    globalBudget: {
+        maxGasPerDay: bigint;
+        remaining: bigint;
+    };
+}
+export interface GuardianInfo {
+    address: Address;
+    label: string;
+    addedAt: number;
+}
+export interface MultiSigProposal {
+    id: string;
+    userOpHash: Hex;
+    signatures: number;
+    threshold: number;
+}
+export interface TimelockOperation {
+    id: string;
+    executeAfter: number;
+    status: 'pending' | 'ready' | 'executed' | 'cancelled';
+}
+export interface RecoveryStatus {
+    pending: boolean;
+    newOwner?: Address;
+    approvals: number;
+    threshold: number;
+    executeAfter?: number;
+    canExecute: boolean;
+    canCancel: boolean;
+}
+export interface DeviceInfo {
+    moduleId: number;
+    name: string;
+    type: 'turnkey' | 'passkey';
+    active: boolean;
+}
+export interface KeyExportResult {
+    privateKey: Hex;
+    address: Address;
+    warning: string;
+}
+export type AuditOperationType = 'execute' | 'deploy' | 'module_install' | 'module_uninstall' | 'recovery_initiate' | 'recovery_execute' | 'freeze' | 'unfreeze';
+export interface AuditOperation {
+    id: string;
+    type: AuditOperationType;
+    userOpHash: Hex;
+    transactionHash: Hex;
+    sender: Address;
+    target: Address;
+    value: string;
+    selector: Hex;
+    signer: Address;
+    signerType: 'turnkey' | 'passkey' | 'session-key' | 'multi-sig';
+    moduleId: number;
+    sponsored: boolean;
+    paymaster?: Address;
+    gasCost: string;
+    success: boolean;
+    blockNumber: number;
+    timestamp: number;
+}
+export interface AuditHistoryQuery {
+    limit?: number;
+    offset?: number;
+    from?: string;
+    to?: string;
+    types?: AuditOperationType[];
+}
+export interface AuditHistoryResult {
+    total: number;
+    operations: AuditOperation[];
+}
+export type WebhookEventType = 'userop.submitted' | 'userop.mined' | 'userop.failed' | 'account.deployed' | 'session_key.installed' | 'session_key.revoked' | 'session_key.expired' | 'recovery.initiated' | 'recovery.executed' | 'guardian.added' | 'guardian.removed' | 'security.freeze' | 'security.alert';
+export interface WebhookConfig {
+    url: string;
+    secret: string;
+    events: WebhookEventType[];
+    filters?: {
+        wallets?: Address[];
+    };
+}
+export interface WebhookInfo extends WebhookConfig {
+    id: string;
+    createdAt: number;
+}
+export interface WebhookEvent {
+    id: string;
+    type: string;
+    timestamp: number;
+    data: Record<string, unknown>;
+    signature: string;
+}
+export interface ChainInfo {
+    id: ChainId;
+    chainId: number;
+    name: string;
+    entryPoint: Address;
+    factory: Address;
+    paymaster: Address;
+    bundlerUrl: string;
+    rip7212: boolean;
+    blockTime: number;
+    features: string[];
+}
+export interface ChainConfig {
+    chainId: number;
+    entryPoint: Address;
+    contracts: {
+        factory: Address;
+        paymaster: Address;
+        webAuthnModule: Address;
+        multiSigModule: Address;
+        sessionKeyModule: Address;
+        socialRecoveryModule: Address;
+        allowlistModule: Address;
+        spendLimitModule: Address;
+        timeRangeModule: Address;
+        paymasterGuardModule: Address;
+    };
+    gas: {
+        safetyMargin: number;
+        minPriorityFee: bigint;
+        estimationMethod: 'bundler' | 'eth_estimateGas';
+    };
+    features: {
+        rip7212: boolean;
+        erc6900: boolean;
+        sponsorship: boolean;
+    };
+}
+export interface ApiKeyPermission {
+    resource: 'wallet' | 'userop' | 'sponsor' | 'auth' | 'session-key' | 'recovery' | 'audit';
+    actions: ('read' | 'write' | 'admin')[];
+}
+export interface ApiKeyQuotas {
+    maxRequestsPerMinute: number;
+    maxRequestsPerDay: number;
+    maxSponsoredGasPerDay: bigint;
+    maxWalletsPerDay: number;
+    maxSessionKeysPerWallet: number;
+}
+export interface FcxWalletClientConfig {
+    apiKey: string;
+    chain: ChainId;
+    entryPoint?: Address;
+    bundlerUrl?: string;
+    paymasterUrl?: string;
+    authUrl?: string;
+    signerIframeUrl?: string;
+}
+export type IframeRequest = {
+    type: 'INIT';
+    origin: string;
+} | {
+    type: 'AUTH_REQUEST';
+    method: 'email' | 'google' | 'apple' | 'facebook' | 'passkey';
+    params: Record<string, unknown>;
+} | {
+    type: 'SIGN_REQUEST';
+    userOpHash: Hex;
+    moduleId: number;
+} | {
+    type: 'EXPORT_REQUEST';
+} | {
+    type: 'LOGOUT';
+};
+export type IframeResponse = {
+    type: 'READY';
+} | {
+    type: 'AUTH_RESPONSE';
+    success: boolean;
+    session?: SessionInfo;
+    error?: string;
+} | {
+    type: 'SIGN_RESPONSE';
+    success: boolean;
+    signature?: Hex;
+    error?: string;
+} | {
+    type: 'EXPORT_RESPONSE';
+    success: boolean;
+    privateKey?: Hex;
+    error?: string;
+} | {
+    type: 'ERROR';
+    code: string;
+    message: string;
+};
+export type SecurityEventType = 'rapid_session_key_creation' | 'unusual_target' | 'high_frequency';
+export interface SecurityEvent {
+    type: SecurityEventType;
+    details: Record<string, unknown>;
+    recommendation: 'freeze' | 'revoke_sessions' | 'review';
+}
+export type WatchtowerAlertType = 'recovery_initiated' | 'owner_changed' | 'module_installed' | 'large_transfer' | 'session_key_installed' | 'upgrade_initiated';
+export interface WatchtowerSubscription {
+    account: Address;
+    alerts: WatchtowerAlertType[];
+    channels: {
+        email?: string;
+        webhook?: string;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,6 @@
+/**
+ * Core type definitions for the FcxWallet SDK.
+ * Corresponds to SPEC-013 Section 18.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/userop/builder.d.ts

@@ -0,0 +1,75 @@
+/**
+ * UserOperation construction pipeline.
+ * Corresponds to SPEC-013 Section 5.2.
+ *
+ * Provides both a fluent builder API and a high-level execute() shortcut.
+ */
+import type { Address, Hex, UserOperation, CallRequest } from '../types.js';
+import { BundlerClient } from '../transport/bundler.js';
+/**
+ * Fluent builder for constructing UserOperations.
+ *
+ * @example
+ * ```ts
+ * const userOp = await new UserOpBuilder(bundler, entryPoint, chainId)
+ *   .setSender(walletAddress)
+ *   .setCallData({ target, value, data })
+ *   .build();
+ * ```
+ */
+export declare class UserOpBuilder {
+    private readonly bundler;
+    private readonly entryPoint;
+    private readonly chainId;
+    private readonly rpcCall?;
+    private userOp;
+    private nonceKey;
+    private initCodeParams?;
+    constructor(bundler: BundlerClient, entryPoint?: Address, chainId?: bigint, rpcCall?: ((method: string, params: unknown[]) => Promise<Hex>) | undefined);
+    /** Set the sender (smart wallet) address */
+    setSender(sender: Address): this;
+    /** Set callData for a single execution */
+    setCallData(call: CallRequest): this;
+    /** Set callData for batch execution */
+    setCallDataBatch(calls: CallRequest[]): this;
+    /** Set raw callData directly */
+    setRawCallData(callData: Hex): this;
+    /** Set the nonce key for parallel streams (default: 0) */
+    setNonce(options: {
+        key: bigint;
+    }): this;
+    /** Set initCode for first-time deployment */
+    setInitCode(params: {
+        factory: Address;
+        owner: Address;
+        salt: bigint;
+    }): this;
+    /** Set raw initCode directly */
+    setRawInitCode(initCode: Hex): this;
+    /** Set paymasterAndData (from paymaster service approval) */
+    setPaymasterAndData(data: Hex): this;
+    /** Set gas fees explicitly */
+    setFees(fees: {
+        maxFeePerGas: bigint;
+        maxPriorityFeePerGas: bigint;
+    }): this;
+    /** Set signature (after signing) */
+    setSignature(signature: Hex): this;
+    /**
+     * Build the UserOperation:
+     * 1. Resolve nonce from EntryPoint
+     * 2. Estimate gas fees
+     * 3. Estimate gas limits with safety margins
+     *
+     * Returns a fully populated UserOperation ready for signing.
+     */
+    build(): Promise<UserOperation>;
+    /**
+     * Compute the hash that must be signed.
+     * MUST match EntryPoint.getUserOpHash() exactly.
+     */
+    getHash(userOp: UserOperation): Hex;
+    /** Get a copy of the current UserOperation state */
+    getUserOp(): UserOperation;
+}
+//# sourceMappingURL=builder.d.ts.map

package/dist/userop/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/userop/builder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAK5E,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAoBxD;;;;;;;;;;GAUG;AACH,qBAAa,aAAa;IAMtB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;IAR3B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,QAAQ,CAAc;IAC9B,OAAO,CAAC,cAAc,CAAC,CAAqD;gBAGzD,OAAO,EAAE,aAAa,EACtB,UAAU,GAAE,OAAwB,EACpC,OAAO,GAAE,MAAe,EACxB,OAAO,CAAC,GAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,aAAA;IAKhF,4CAA4C;IAC5C,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAKhC,0CAA0C;IAC1C,WAAW,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAKpC,uCAAuC;IACvC,gBAAgB,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,IAAI;IAK5C,gCAAgC;IAChC,cAAc,CAAC,QAAQ,EAAE,GAAG,GAAG,IAAI;IAKnC,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAKxC,6CAA6C;IAC7C,WAAW,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAM7E,gCAAgC;IAChC,cAAc,CAAC,QAAQ,EAAE,GAAG,GAAG,IAAI;IAKnC,6DAA6D;IAC7D,mBAAmB,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI;IAKpC,8BAA8B;IAC9B,OAAO,CAAC,IAAI,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,oBAAoB,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAM3E,oCAAoC;IACpC,YAAY,CAAC,SAAS,EAAE,GAAG,GAAG,IAAI;IAKlC;;;;;;;OAOG;IACG,KAAK,IAAI,OAAO,CAAC,aAAa,CAAC;IA6BrC;;;OAGG;IACH,OAAO,CAAC,MAAM,EAAE,aAAa,GAAG,GAAG;IAInC,oDAAoD;IACpD,SAAS,IAAI,aAAa;CAG3B"}

package/dist/userop/builder.js

@@ -0,0 +1,150 @@
+/**
+ * UserOperation construction pipeline.
+ * Corresponds to SPEC-013 Section 5.2.
+ *
+ * Provides both a fluent builder API and a high-level execute() shortcut.
+ */
+import { encodeCallData, encodeBatchCallData, encodeInitCode } from './encoding.js';
+import { getUserOpHash } from './hash.js';
+import { estimateGas, estimateFees } from './gas.js';
+import { NonceManager } from './nonce.js';
+import { ENTRYPOINT_V06 } from '../core/config.js';
+/** Empty UserOperation with all fields zeroed */
+function emptyUserOp(sender) {
+    return {
+        sender,
+        nonce: 0n,
+        initCode: '0x',
+        callData: '0x',
+        callGasLimit: 0n,
+        verificationGasLimit: 0n,
+        preVerificationGas: 0n,
+        maxFeePerGas: 0n,
+        maxPriorityFeePerGas: 0n,
+        paymasterAndData: '0x',
+        signature: '0x',
+    };
+}
+/**
+ * Fluent builder for constructing UserOperations.
+ *
+ * @example
+ * ```ts
+ * const userOp = await new UserOpBuilder(bundler, entryPoint, chainId)
+ *   .setSender(walletAddress)
+ *   .setCallData({ target, value, data })
+ *   .build();
+ * ```
+ */
+export class UserOpBuilder {
+    bundler;
+    entryPoint;
+    chainId;
+    rpcCall;
+    userOp;
+    nonceKey = 0n;
+    initCodeParams;
+    constructor(bundler, entryPoint = ENTRYPOINT_V06, chainId = 42161n, rpcCall) {
+        this.bundler = bundler;
+        this.entryPoint = entryPoint;
+        this.chainId = chainId;
+        this.rpcCall = rpcCall;
+        this.userOp = emptyUserOp('0x0000000000000000000000000000000000000000');
+    }
+    /** Set the sender (smart wallet) address */
+    setSender(sender) {
+        this.userOp.sender = sender;
+        return this;
+    }
+    /** Set callData for a single execution */
+    setCallData(call) {
+        this.userOp.callData = encodeCallData(call);
+        return this;
+    }
+    /** Set callData for batch execution */
+    setCallDataBatch(calls) {
+        this.userOp.callData = encodeBatchCallData(calls);
+        return this;
+    }
+    /** Set raw callData directly */
+    setRawCallData(callData) {
+        this.userOp.callData = callData;
+        return this;
+    }
+    /** Set the nonce key for parallel streams (default: 0) */
+    setNonce(options) {
+        this.nonceKey = options.key;
+        return this;
+    }
+    /** Set initCode for first-time deployment */
+    setInitCode(params) {
+        this.initCodeParams = params;
+        this.userOp.initCode = encodeInitCode(params);
+        return this;
+    }
+    /** Set raw initCode directly */
+    setRawInitCode(initCode) {
+        this.userOp.initCode = initCode;
+        return this;
+    }
+    /** Set paymasterAndData (from paymaster service approval) */
+    setPaymasterAndData(data) {
+        this.userOp.paymasterAndData = data;
+        return this;
+    }
+    /** Set gas fees explicitly */
+    setFees(fees) {
+        this.userOp.maxFeePerGas = fees.maxFeePerGas;
+        this.userOp.maxPriorityFeePerGas = fees.maxPriorityFeePerGas;
+        return this;
+    }
+    /** Set signature (after signing) */
+    setSignature(signature) {
+        this.userOp.signature = signature;
+        return this;
+    }
+    /**
+     * Build the UserOperation:
+     * 1. Resolve nonce from EntryPoint
+     * 2. Estimate gas fees
+     * 3. Estimate gas limits with safety margins
+     *
+     * Returns a fully populated UserOperation ready for signing.
+     */
+    async build() {
+        // Resolve nonce
+        if (this.rpcCall) {
+            const nonceManager = new NonceManager(this.entryPoint, this.rpcCall);
+            this.userOp.nonce = await nonceManager.get(this.userOp.sender, this.nonceKey);
+        }
+        // Estimate fees if not set
+        if (this.userOp.maxFeePerGas === 0n && this.rpcCall) {
+            const fees = await estimateFees(this.rpcCall);
+            this.userOp.maxFeePerGas = fees.maxFeePerGas;
+            this.userOp.maxPriorityFeePerGas = fees.maxPriorityFeePerGas;
+        }
+        // Estimate gas with safety margins
+        // Use a dummy signature for estimation
+        const estimationOp = {
+            ...this.userOp,
+            signature: '0x' + 'ff'.repeat(69), // Dummy 69-byte signature
+        };
+        const estimated = await estimateGas(this.bundler, estimationOp);
+        return {
+            ...estimated,
+            signature: '0x', // Clear dummy signature
+        };
+    }
+    /**
+     * Compute the hash that must be signed.
+     * MUST match EntryPoint.getUserOpHash() exactly.
+     */
+    getHash(userOp) {
+        return getUserOpHash(userOp, this.entryPoint, this.chainId);
+    }
+    /** Get a copy of the current UserOperation state */
+    getUserOp() {
+        return { ...this.userOp };
+    }
+}
+//# sourceMappingURL=builder.js.map

package/dist/userop/builder.js.map

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

package/dist/userop/encoding.d.ts

@@ -0,0 +1,44 @@
+/**
+ * UserOperation callData and initCode encoding.
+ * Corresponds to SPEC-013 Sections 4-5, SPEC-002.
+ */
+import { type Abi } from 'viem';
+import type { Address, Hex } from '../types.js';
+/**
+ * Encode callData for a single execute call on the smart account.
+ */
+export declare function encodeCallData(params: {
+    target: Address;
+    value: bigint;
+    data: Hex;
+}): Hex;
+/**
+ * Encode callData for a batch execute call on the smart account.
+ */
+export declare function encodeBatchCallData(calls: Array<{
+    target: Address;
+    value: bigint;
+    data: Hex;
+}>): Hex;
+/**
+ * Encode initCode for first-time account deployment.
+ * Format: factory address (20 bytes) + factory.createAccount(owner, salt) calldata
+ *
+ * @param factory - The factory contract address
+ * @param owner - The initial owner/signer address
+ * @param salt - Deployment salt for CREATE2
+ */
+export declare function encodeInitCode(params: {
+    factory: Address;
+    owner: Address;
+    salt: bigint;
+}): Hex;
+/**
+ * Encode arbitrary function call data using an ABI.
+ */
+export declare function encodeCall(params: {
+    abi: Abi;
+    functionName: string;
+    args?: readonly unknown[];
+}): Hex;
+//# sourceMappingURL=encoding.d.ts.map

package/dist/userop/encoding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoding.d.ts","sourceRoot":"","sources":["../../src/userop/encoding.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAIL,KAAK,GAAG,EACT,MAAM,MAAM,CAAC;AACd,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAoDhD;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE;IACrC,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,GAAG,CAAC;CACX,GAAG,GAAG,CAMN;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,KAAK,CAAC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,GAAG,CAAA;CAAE,CAAC,GAC1D,GAAG,CAML;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,GAAG,CAQN;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE;IACjC,GAAG,EAAE,GAAG,CAAC;IACT,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;CAC3B,GAAG,GAAG,CAMN"}