@absol-labs/agent 0.5.0 → 0.7.0

package/src/wallet/autonomous-wallet-protocol.ts

@@ -0,0 +1,71 @@
+import type { Address, Hex } from "viem";
+
+export const AUTONOMOUS_WALLET_VERSION = 1 as const;
+export const AUTONOMOUS_WALLET_CHAIN_ID = 84532 as const;
+export const AUTONOMOUS_WALLET_CAIP2 = "eip155:84532" as const;
+
+export interface PreparedPrivyRequest {
+  readonly requestId: string;
+  readonly walletId: string;
+  readonly method: "eth_sendTransaction" | "eth_signTypedData_v4";
+  /** Base64 of the exact canonical Privy authorization payload. */
+  readonly payload: string;
+  readonly expiresAt: number;
+}
+
+export interface AutonomousWalletProof {
+  readonly version: typeof AUTONOMOUS_WALLET_VERSION;
+  readonly appId: string;
+  readonly chainId: typeof AUTONOMOUS_WALLET_CHAIN_ID;
+  readonly publicKey: string;
+  readonly nonce: string;
+  readonly issuedAt: number;
+  /** Base64 DER ECDSA P-256 signature over {@link autonomousProofBytes}. */
+  readonly signature: string;
+}
+
+export interface AutonomousWalletBroker {
+  provision(input: {
+    readonly appId: string;
+    readonly chainId: typeof AUTONOMOUS_WALLET_CHAIN_ID;
+    readonly publicKey: string;
+    readonly proof: AutonomousWalletProof;
+    readonly idempotencyKey: string;
+  }): Promise<{
+    readonly walletId: string;
+    readonly address: Address;
+    readonly policyId: string;
+  }>;
+  prepare(input: {
+    readonly walletId: string;
+    readonly publicKey: string;
+    readonly method: "eth_sendTransaction" | "eth_signTypedData_v4";
+    readonly params: readonly unknown[];
+  }): Promise<PreparedPrivyRequest>;
+  execute(input: {
+    readonly requestId: string;
+    readonly publicKey: string;
+    readonly signature: string;
+  }): Promise<Hex>;
+}
+
+/** Canonical proof-of-possession bytes shared by the agent and broker. */
+export function autonomousProofBytes(input: {
+  readonly version: typeof AUTONOMOUS_WALLET_VERSION;
+  readonly appId: string;
+  readonly chainId: typeof AUTONOMOUS_WALLET_CHAIN_ID;
+  readonly publicKey: string;
+  readonly nonce: string;
+  readonly issuedAt: number;
+}): Uint8Array {
+  return new TextEncoder().encode(
+    JSON.stringify({
+      appId: input.appId,
+      chainId: input.chainId,
+      nonce: input.nonce,
+      publicKey: input.publicKey,
+      version: input.version,
+      issuedAt: input.issuedAt,
+    }),
+  );
+}