@andrewkimjoseph/celina 0.2.17 → 0.3.0

package/build/clients/self-api.js

@@ -0,0 +1,242 @@
+import { SELF_API_BASE, SELF_API_NETWORK, SELF_CHAIN_ID, } from "../config/self.js";
+const DEFAULT_POLL_INTERVAL_MS = 5000;
+const DEFAULT_TIMEOUT_MS = 30 * 60 * 1000;
+export class SelfApiError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "SelfApiError";
+    }
+}
+export class SelfExpiredSessionError extends Error {
+    constructor(message = "Session expired. Start a new registration flow.") {
+        super(message);
+        this.name = "SelfExpiredSessionError";
+    }
+}
+function resolveApiBase(apiBase) {
+    return (apiBase ?? process.env.SELF_AGENT_API_BASE ?? SELF_API_BASE).replace(/\/+$/, "");
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function apiFetch(url, init) {
+    const res = await fetch(url, init);
+    const body = (await res.json());
+    if (!res.ok) {
+        const errorMsg = typeof body.error === "string" ? body.error : `HTTP ${res.status}`;
+        throw new SelfApiError(errorMsg);
+    }
+    return body;
+}
+function sessionAuthHeaders(sessionToken) {
+    return { Authorization: `Bearer ${sessionToken}` };
+}
+async function fetchSessionStatus(apiBase, path, sessionToken) {
+    return apiFetch(`${apiBase}${path}?token=${encodeURIComponent(sessionToken)}`, { headers: sessionAuthHeaders(sessionToken) });
+}
+function handleSessionStatusError(error, expiredMessage) {
+    if (error instanceof SelfApiError &&
+        error.message.toLowerCase().includes("expired")) {
+        throw new SelfExpiredSessionError(expiredMessage);
+    }
+    throw error;
+}
+function optionalScanUrl(data) {
+    return typeof data.scanUrl === "string" ? data.scanUrl : undefined;
+}
+function buildRegistrationSession(data, apiBase) {
+    let currentToken = String(data.sessionToken);
+    return {
+        sessionToken: currentToken,
+        stage: String(data.stage),
+        deepLink: String(data.deepLink),
+        scanUrl: optionalScanUrl(data),
+        agentAddress: String(data.agentAddress),
+        expiresAt: String(data.expiresAt),
+        timeRemainingMs: typeof data.timeRemainingMs === "number" ? data.timeRemainingMs : undefined,
+        humanInstructions: Array.isArray(data.humanInstructions)
+            ? data.humanInstructions.map(String)
+            : [],
+        async waitForCompletion(opts) {
+            const timeout = opts?.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+            const interval = opts?.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+            const deadline = Date.now() + timeout;
+            while (Date.now() < deadline) {
+                await sleep(interval);
+                let status;
+                try {
+                    status = await fetchSessionStatus(apiBase, "/api/agent/register/status", currentToken);
+                }
+                catch (error) {
+                    handleSessionStatusError(error, "Session expired. Start a new registration flow.");
+                }
+                currentToken = String(status.sessionToken);
+                if (status.stage === "completed") {
+                    return {
+                        agentId: Number(status.agentId),
+                        agentAddress: String(status.agentAddress ?? data.agentAddress),
+                        credentials: status.credentials,
+                        txHash: typeof status.txHash === "string" ? status.txHash : undefined,
+                    };
+                }
+                if (status.stage === "failed") {
+                    throw new SelfApiError("Registration failed on-chain.");
+                }
+                if (status.stage === "expired") {
+                    throw new SelfExpiredSessionError();
+                }
+            }
+            throw new SelfApiError(`Registration did not complete within ${timeout}ms. Call check_self_registration again to resume polling.`);
+        },
+        async exportKey() {
+            const result = await apiFetch(`${apiBase}/api/agent/register/export`, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    ...sessionAuthHeaders(currentToken),
+                },
+                body: JSON.stringify({ token: currentToken }),
+            });
+            return result.privateKey;
+        },
+    };
+}
+function buildRefreshSession(data, apiBase) {
+    let currentToken = String(data.sessionToken);
+    return {
+        sessionToken: currentToken,
+        stage: String(data.stage),
+        deepLink: String(data.deepLink),
+        scanUrl: optionalScanUrl(data),
+        expiresAt: String(data.expiresAt),
+        timeRemainingMs: typeof data.timeRemainingMs === "number" ? data.timeRemainingMs : undefined,
+        humanInstructions: Array.isArray(data.humanInstructions)
+            ? data.humanInstructions.map(String)
+            : [],
+        async waitForCompletion(opts) {
+            const timeout = opts?.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+            const interval = opts?.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+            const deadline = Date.now() + timeout;
+            while (Date.now() < deadline) {
+                await sleep(interval);
+                let status;
+                try {
+                    status = await fetchSessionStatus(apiBase, "/api/agent/refresh/status", currentToken);
+                }
+                catch (error) {
+                    handleSessionStatusError(error, "Proof refresh session expired. Call refresh_self_proof to start a new session.");
+                }
+                currentToken = String(status.sessionToken);
+                if (status.stage === "completed") {
+                    const expiresAtRaw = status.proofExpiresAt;
+                    const proofExpiresAt = typeof expiresAtRaw === "string" || typeof expiresAtRaw === "number"
+                        ? new Date(expiresAtRaw)
+                        : new Date(Date.now() + 365 * 24 * 60 * 60 * 1000);
+                    return { proofExpiresAt };
+                }
+                if (status.stage === "failed") {
+                    throw new SelfApiError("Proof refresh failed on-chain.");
+                }
+                if (status.stage === "expired") {
+                    throw new SelfExpiredSessionError("Proof refresh session expired. Call refresh_self_proof to start a new session.");
+                }
+            }
+            throw new SelfApiError(`Proof refresh did not complete within ${timeout}ms. Call check_self_registration again to resume polling.`);
+        },
+    };
+}
+function buildDeregistrationSession(data, apiBase) {
+    let currentToken = String(data.sessionToken);
+    return {
+        sessionToken: currentToken,
+        stage: String(data.stage),
+        deepLink: String(data.deepLink),
+        scanUrl: optionalScanUrl(data),
+        expiresAt: String(data.expiresAt),
+        timeRemainingMs: typeof data.timeRemainingMs === "number" ? data.timeRemainingMs : undefined,
+        humanInstructions: Array.isArray(data.humanInstructions)
+            ? data.humanInstructions.map(String)
+            : [],
+        async waitForCompletion(opts) {
+            const timeout = opts?.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+            const interval = opts?.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+            const deadline = Date.now() + timeout;
+            while (Date.now() < deadline) {
+                await sleep(interval);
+                let status;
+                try {
+                    status = await fetchSessionStatus(apiBase, "/api/agent/deregister/status", currentToken);
+                }
+                catch (error) {
+                    handleSessionStatusError(error, "Deregistration session expired. Call deregister_self_agent to start a new session.");
+                }
+                currentToken = String(status.sessionToken);
+                if (status.stage === "completed") {
+                    return;
+                }
+                if (status.stage === "failed") {
+                    throw new SelfApiError("Deregistration failed on-chain.");
+                }
+                if (status.stage === "expired") {
+                    throw new SelfExpiredSessionError("Deregistration session expired. Call deregister_self_agent to start a new session.");
+                }
+            }
+            throw new SelfApiError(`Deregistration did not complete within ${timeout}ms. Call check_self_registration again to resume polling.`);
+        },
+    };
+}
+export async function requestRegistration(opts) {
+    const base = resolveApiBase(opts.apiBase);
+    const payload = {
+        mode: opts.mode ?? "wallet-free",
+        network: SELF_API_NETWORK,
+        disclosures: opts.disclosures,
+        humanAddress: opts.humanAddress,
+        agentName: opts.agentName,
+        agentDescription: opts.agentDescription,
+    };
+    const data = await apiFetch(`${base}/api/agent/register`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(payload),
+    });
+    return buildRegistrationSession(data, base);
+}
+export async function requestDeregistration(opts) {
+    const base = resolveApiBase(opts.apiBase);
+    const data = await apiFetch(`${base}/api/agent/deregister`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+            network: SELF_API_NETWORK,
+            agentAddress: opts.agentAddress,
+            disclosures: opts.disclosures,
+        }),
+    });
+    return buildDeregistrationSession(data, base);
+}
+export async function requestProofRefresh(opts) {
+    const base = resolveApiBase(opts.apiBase);
+    const data = await apiFetch(`${base}/api/agent/refresh`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+            agentId: opts.agentId,
+            network: SELF_API_NETWORK,
+            disclosures: opts.disclosures,
+        }),
+    });
+    return buildRefreshSession(data, base);
+}
+export async function getAgentInfo(agentId, apiBase) {
+    const base = resolveApiBase(apiBase);
+    return apiFetch(`${base}/api/agent/info/${SELF_CHAIN_ID}/${agentId}`);
+}
+export async function getAgentsForHuman(address, apiBase) {
+    const base = resolveApiBase(apiBase);
+    return apiFetch(`${base}/api/agent/agents/${SELF_CHAIN_ID}/${address}`);
+}
+export function selfQrUrl(sessionToken, apiBase) {
+    return `${resolveApiBase(apiBase)}/scan/${sessionToken}`;
+}
+//# sourceMappingURL=self-api.js.map

package/build/clients/self-api.js.map

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

package/build/config/env.d.ts

@@ -1,5 +1,6 @@
 export interface AppConfig {
     rpcUrl: string;
     privateKey?: `0x${string}`;
+    selfAgentPrivateKey?: `0x${string}`;
 }
 export declare function loadConfig(): AppConfig;

package/build/config/env.js

@@ -2,6 +2,7 @@ export function loadConfig() {
     return {
         rpcUrl: process.env.CELO_RPC_URL_MAINNET ?? "https://forno.celo.org",
         privateKey: process.env.CELO_PRIVATE_KEY,
+        selfAgentPrivateKey: process.env.SELF_AGENT_PRIVATE_KEY,
     };
 }
 //# sourceMappingURL=env.js.map

package/build/config/env.js.map

@@ -1 +1 @@
-{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/config/env.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,UAAU;IACxB,OAAO;QACL,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,wBAAwB;QACpE,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,gBAA6C;KACtE,CAAC;AACJ,CAAC"}
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/config/env.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,UAAU;IACxB,OAAO;QACL,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,wBAAwB;QACpE,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,gBAA6C;QACrE,mBAAmB,EAAE,OAAO,CAAC,GAAG,CAAC,sBAEpB;KACd,CAAC;AACJ,CAAC"}

package/build/config/self.d.ts

@@ -0,0 +1,22 @@
+export declare const SELF_REGISTRY_ADDRESS: "0xaC3DF9ABf80d0F5c020C06B04Cced27763355944";
+export declare const SELF_API_BASE = "https://app.ai.self.xyz";
+/** Network value for Self lifecycle REST APIs (register, refresh, deregister). */
+export declare const SELF_API_NETWORK = "mainnet";
+/** Query param for Self demo/gated HTTP endpoints on Celo mainnet. */
+export declare const SELF_DEMO_NETWORK = "celo-mainnet";
+export declare const SELF_CHAIN_ID = 42220;
+export declare function selfDemoUrl(path: string, network?: string): string;
+export declare const SELF_SESSION_TTL_MS: number;
+export declare const SELF_MAX_SESSIONS = 50;
+export declare const SELF_DEFAULT_MAX_AGE_MS: number;
+export declare const SELF_FETCH_MAX_BYTES: number;
+/** Warning threshold for upcoming proof expiry (matches Self SDK isProofExpiringSoon). */
+export declare const SELF_PROOF_EXPIRING_SOON_DAYS = 30;
+export declare const SELF_HEADERS: {
+    readonly ADDRESS: "x-self-agent-address";
+    readonly SIGNATURE: "x-self-agent-signature";
+    readonly TIMESTAMP: "x-self-agent-timestamp";
+    readonly KEYTYPE: "x-self-agent-keytype";
+    readonly KEY: "x-self-agent-key";
+};
+export type SelfRegistrationMode = "linked" | "wallet-free" | "smartwallet" | "self-custody" | "ed25519" | "ed25519-linked";

package/build/config/self.js

@@ -0,0 +1,27 @@
+export const SELF_REGISTRY_ADDRESS = "0xaC3DF9ABf80d0F5c020C06B04Cced27763355944";
+export const SELF_API_BASE = "https://app.ai.self.xyz";
+/** Network value for Self lifecycle REST APIs (register, refresh, deregister). */
+export const SELF_API_NETWORK = "mainnet";
+/** Query param for Self demo/gated HTTP endpoints on Celo mainnet. */
+export const SELF_DEMO_NETWORK = "celo-mainnet";
+export const SELF_CHAIN_ID = 42220;
+export function selfDemoUrl(path, network = SELF_DEMO_NETWORK) {
+    const base = SELF_API_BASE.replace(/\/+$/, "");
+    const normalizedPath = path.startsWith("/") ? path : `/${path}`;
+    const separator = normalizedPath.includes("?") ? "&" : "?";
+    return `${base}${normalizedPath}${separator}network=${network}`;
+}
+export const SELF_SESSION_TTL_MS = 10 * 60 * 1000;
+export const SELF_MAX_SESSIONS = 50;
+export const SELF_DEFAULT_MAX_AGE_MS = 5 * 60 * 1000;
+export const SELF_FETCH_MAX_BYTES = 10 * 1024;
+/** Warning threshold for upcoming proof expiry (matches Self SDK isProofExpiringSoon). */
+export const SELF_PROOF_EXPIRING_SOON_DAYS = 30;
+export const SELF_HEADERS = {
+    ADDRESS: "x-self-agent-address",
+    SIGNATURE: "x-self-agent-signature",
+    TIMESTAMP: "x-self-agent-timestamp",
+    KEYTYPE: "x-self-agent-keytype",
+    KEY: "x-self-agent-key",
+};
+//# sourceMappingURL=self.js.map

package/build/config/self.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"self.js","sourceRoot":"","sources":["../../src/config/self.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAChC,4CAAqD,CAAC;AAExD,MAAM,CAAC,MAAM,aAAa,GAAG,yBAAyB,CAAC;AAEvD,kFAAkF;AAClF,MAAM,CAAC,MAAM,gBAAgB,GAAG,SAAS,CAAC;AAE1C,sEAAsE;AACtE,MAAM,CAAC,MAAM,iBAAiB,GAAG,cAAc,CAAC;AAEhD,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,CAAC;AAEnC,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,OAAO,GAAG,iBAAiB;IACnE,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC/C,MAAM,cAAc,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;IAChE,MAAM,SAAS,GAAG,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IAC3D,OAAO,GAAG,IAAI,GAAG,cAAc,GAAG,SAAS,WAAW,OAAO,EAAE,CAAC;AAClE,CAAC;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAElD,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAEpC,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;AAErD,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,GAAG,IAAI,CAAC;AAE9C,0FAA0F;AAC1F,MAAM,CAAC,MAAM,6BAA6B,GAAG,EAAE,CAAC;AAEhD,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,OAAO,EAAE,sBAAsB;IAC/B,SAAS,EAAE,wBAAwB;IACnC,SAAS,EAAE,wBAAwB;IACnC,OAAO,EAAE,sBAAsB;IAC/B,GAAG,EAAE,kBAAkB;CACf,CAAC"}

package/build/context/app-context.d.ts

@@ -6,10 +6,12 @@ import { TransactionService } from "../services/transaction.service.js";
 import { MentoFxService } from "../services/mento-fx.service.js";
 import { GoodDollarService } from "../services/gooddollar.service.js";
 import { AaveService } from "../services/aave.service.js";
+import { SelfService } from "../services/self.service.js";
 export interface AppContext {
     config: {
         hasWallet: boolean;
         walletAddress?: `0x${string}`;
+        hasSelfAgentKey: boolean;
     };
     blockchain: BlockchainService;
     account: AccountService;
@@ -18,5 +20,6 @@ export interface AppContext {
     mentoFx: MentoFxService;
     gooddollar: GoodDollarService;
     aave: AaveService;
+    self: SelfService;
 }
-export declare function createAppContext(clientFactory: CeloClientFactory, walletAddress?: `0x${string}`): AppContext;
+export declare function createAppContext(clientFactory: CeloClientFactory, walletAddress?: `0x${string}`, selfAgentPrivateKey?: `0x${string}`): AppContext;

package/build/context/app-context.js

@@ -5,11 +5,13 @@ import { TransactionService } from "../services/transaction.service.js";
 import { MentoFxService } from "../services/mento-fx.service.js";
 import { GoodDollarService } from "../services/gooddollar.service.js";
 import { AaveService } from "../services/aave.service.js";
-export function createAppContext(clientFactory, walletAddress) {
+import { SelfService } from "../services/self.service.js";
+export function createAppContext(clientFactory, walletAddress, selfAgentPrivateKey) {
     return {
         config: {
             hasWallet: Boolean(walletAddress),
             walletAddress,
+            hasSelfAgentKey: Boolean(selfAgentPrivateKey),
         },
         blockchain: new BlockchainService(clientFactory),
         account: new AccountService(clientFactory),
@@ -18,6 +20,7 @@ export function createAppContext(clientFactory, walletAddress) {
         mentoFx: new MentoFxService(clientFactory),
         gooddollar: new GoodDollarService(clientFactory),
         aave: new AaveService(clientFactory),
+        self: new SelfService(clientFactory, selfAgentPrivateKey),
     };
 }
 //# sourceMappingURL=app-context.js.map

package/build/context/app-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-context.js","sourceRoot":"","sources":["../../src/context/app-context.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAgB1D,MAAM,UAAU,gBAAgB,CAC9B,aAAgC,EAChC,aAA6B;IAE7B,OAAO;QACL,MAAM,EAAE;YACN,SAAS,EAAE,OAAO,CAAC,aAAa,CAAC;YACjC,aAAa;SACd;QACD,UAAU,EAAE,IAAI,iBAAiB,CAAC,aAAa,CAAC;QAChD,OAAO,EAAE,IAAI,cAAc,CAAC,aAAa,CAAC;QAC1C,KAAK,EAAE,IAAI,YAAY,CAAC,aAAa,CAAC;QACtC,WAAW,EAAE,IAAI,kBAAkB,CAAC,aAAa,CAAC;QAClD,OAAO,EAAE,IAAI,cAAc,CAAC,aAAa,CAAC;QAC1C,UAAU,EAAE,IAAI,iBAAiB,CAAC,aAAa,CAAC;QAChD,IAAI,EAAE,IAAI,WAAW,CAAC,aAAa,CAAC;KACrC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"app-context.js","sourceRoot":"","sources":["../../src/context/app-context.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAkB1D,MAAM,UAAU,gBAAgB,CAC9B,aAAgC,EAChC,aAA6B,EAC7B,mBAAmC;IAEnC,OAAO;QACL,MAAM,EAAE;YACN,SAAS,EAAE,OAAO,CAAC,aAAa,CAAC;YACjC,aAAa;YACb,eAAe,EAAE,OAAO,CAAC,mBAAmB,CAAC;SAC9C;QACD,UAAU,EAAE,IAAI,iBAAiB,CAAC,aAAa,CAAC;QAChD,OAAO,EAAE,IAAI,cAAc,CAAC,aAAa,CAAC;QAC1C,KAAK,EAAE,IAAI,YAAY,CAAC,aAAa,CAAC;QACtC,WAAW,EAAE,IAAI,kBAAkB,CAAC,aAAa,CAAC;QAClD,OAAO,EAAE,IAAI,cAAc,CAAC,aAAa,CAAC;QAC1C,UAAU,EAAE,IAAI,iBAAiB,CAAC,aAAa,CAAC;QAChD,IAAI,EAAE,IAAI,WAAW,CAAC,aAAa,CAAC;QACpC,IAAI,EAAE,IAAI,WAAW,CAAC,aAAa,EAAE,mBAAmB,CAAC;KAC1D,CAAC;AACJ,CAAC"}

package/build/server/create-server.js

@@ -15,7 +15,7 @@ export function createServer() {
             logging: {},
         },
     });
-    registerAllTools(server, createAppContext(clientFactory, clients.accountAddress));
+    registerAllTools(server, createAppContext(clientFactory, clients.accountAddress, config.selfAgentPrivateKey));
     return server;
 }
 //# sourceMappingURL=create-server.js.map

package/build/server/create-server.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-server.js","sourceRoot":"","sources":["../../src/server/create-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,aAAa,GAAG,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACpD,MAAM,OAAO,GAAG,aAAa,CAAC,UAAU,EAAE,CAAC;IAE3C,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,EACpC;QACE,YAAY,EAAE,mBAAmB;QACjC,YAAY,EAAE;YACZ,KAAK,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE;YAC5B,OAAO,EAAE,EAAE;SACZ;KACF,CACF,CAAC;IAEF,gBAAgB,CACd,MAAM,EACN,gBAAgB,CAAC,aAAa,EAAE,OAAO,CAAC,cAAc,CAAC,CACxD,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"create-server.js","sourceRoot":"","sources":["../../src/server/create-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,aAAa,GAAG,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACpD,MAAM,OAAO,GAAG,aAAa,CAAC,UAAU,EAAE,CAAC;IAE3C,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,EACpC;QACE,YAAY,EAAE,mBAAmB;QACjC,YAAY,EAAE;YACZ,KAAK,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE;YAC5B,OAAO,EAAE,EAAE;SACZ;KACF,CACF,CAAC;IAEF,gBAAgB,CACd,MAAM,EACN,gBAAgB,CACd,aAAa,EACb,OAAO,CAAC,cAAc,EACtB,MAAM,CAAC,mBAAmB,CAC3B,CACF,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/build/server/instructions.js

@@ -11,7 +11,11 @@ Guidelines:
 - Use get_gooddollar_whitelisting_info to check GoodDollar IdentityV4 whitelist status, whitelisting date, and reverification progress for a wallet.
 - Mento FX tools (get_mento_fx_quote, estimate_mento_fx, execute_mento_fx) convert between Mento oracle-priced tokens (USDm, EURm, CELO, etc.). They are unavailable when the Mento FX market is closed.
 - Aave tools (supply_aave_usdt, withdraw_aave_usdt) supply and withdraw USDT on Aave V3 Celo. Use get_celo_balances with tokens ["USDT"] before supplying; use withdrawMax on withdraw to redeem the full supplied balance.
-
-Future tools (add as new modules in src/tools/): Self verify, Self Agent ID check.
+- Self Agent ID tools (ai.self.xyz on Celo mainnet):
+  - Read: verify_self_agent, lookup_self_agent, verify_self_request, get_self_identity
+  - Register: register_self_agent → human scans QR → check_self_registration (returns private_key_hex on success)
+  - Lifecycle: refresh_self_proof (only after on-chain proof expiry), deregister_self_agent (poll with check_self_registration)
+  - Auth: sign_self_request, authenticated_self_fetch (require SELF_AGENT_PRIVATE_KEY or encryptedSelfAgentPrivateKey). For Self demo/gated APIs use ?network=celo-mainnet (not mainnet), e.g. POST https://app.ai.self.xyz/api/demo/verify?network=celo-mainnet
+- Self agent keys are separate from CELO_PRIVATE_KEY. Registration sessions are in-memory (~10 min TTL); HTTP multi-instance hosting may require sticky sessions.
 `.trim();
 //# sourceMappingURL=instructions.js.map

package/build/server/instructions.js.map

@@ -1 +1 @@
-{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../../src/server/instructions.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;CAelC,CAAC,IAAI,EAAE,CAAC"}
+{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../../src/server/instructions.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;CAmBlC,CAAC,IAAI,EAAE,CAAC"}

package/build/services/self-session-store.d.ts

@@ -0,0 +1,19 @@
+import type { SelfDeregistrationSession, SelfRefreshSession, SelfRegistrationSession } from "../clients/self-api.js";
+export type SelfSessionKind = "registration" | "refresh" | "deregistration";
+export type StoredSelfSession = {
+    kind: "registration";
+    session: SelfRegistrationSession;
+    createdAt: number;
+} | {
+    kind: "refresh";
+    session: SelfRefreshSession;
+    createdAt: number;
+} | {
+    kind: "deregistration";
+    session: SelfDeregistrationSession;
+    createdAt: number;
+};
+export declare function storeSelfSession(sessionToken: string, entry: StoredSelfSession): void;
+export declare function getSelfSession(sessionToken: string): StoredSelfSession | undefined;
+export declare function deleteSelfSession(sessionToken: string): void;
+export declare function clearSelfSessionsForTests(): void;

package/build/services/self-session-store.js

@@ -0,0 +1,28 @@
+import { SELF_MAX_SESSIONS, SELF_SESSION_TTL_MS } from "../config/self.js";
+const sessions = new Map();
+function pruneExpiredSessions() {
+    const now = Date.now();
+    for (const [key, entry] of sessions) {
+        if (now - entry.createdAt > SELF_SESSION_TTL_MS) {
+            sessions.delete(key);
+        }
+    }
+}
+export function storeSelfSession(sessionToken, entry) {
+    pruneExpiredSessions();
+    if (sessions.size >= SELF_MAX_SESSIONS) {
+        throw new Error("Too many active Self sessions. Wait for existing sessions to expire (10 minutes) or restart the server.");
+    }
+    sessions.set(sessionToken, entry);
+}
+export function getSelfSession(sessionToken) {
+    pruneExpiredSessions();
+    return sessions.get(sessionToken);
+}
+export function deleteSelfSession(sessionToken) {
+    sessions.delete(sessionToken);
+}
+export function clearSelfSessionsForTests() {
+    sessions.clear();
+}
+//# sourceMappingURL=self-session-store.js.map

package/build/services/self-session-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-session-store.js","sourceRoot":"","sources":["../../src/services/self-session-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AA0B3E,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA6B,CAAC;AAEtD,SAAS,oBAAoB;IAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEvB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,QAAQ,EAAE,CAAC;QACpC,IAAI,GAAG,GAAG,KAAK,CAAC,SAAS,GAAG,mBAAmB,EAAE,CAAC;YAChD,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,YAAoB,EACpB,KAAwB;IAExB,oBAAoB,EAAE,CAAC;IAEvB,IAAI,QAAQ,CAAC,IAAI,IAAI,iBAAiB,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CACb,yGAAyG,CAC1G,CAAC;IACJ,CAAC;IAED,QAAQ,CAAC,GAAG,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,YAAoB;IACjD,oBAAoB,EAAE,CAAC;IACvB,OAAO,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,YAAoB;IACpD,QAAQ,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,yBAAyB;IACvC,QAAQ,CAAC,KAAK,EAAE,CAAC;AACnB,CAAC"}