@andrewkimjoseph/celina-sdk 0.15.1 → 0.15.2

package/build/src/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/src/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"}

package/build/src/services/self.service.d.ts

@@ -0,0 +1,241 @@
+import { type Hex } from "viem";
+import type { SelfRegistrationMode } from "../config/self.js";
+import type { SdkConfig } from "../config/sdk-config.js";
+import type { CeloClientFactory } from "../clients/celo-client.js";
+export interface VerifySelfAgentParams {
+    agentAddress: `0x${string}`;
+    requireAge?: 0 | 18 | 21;
+    requireOfac?: boolean;
+    requireSelfProvider?: boolean;
+}
+export interface VerifySelfRequestParams {
+    agentSignature: Hex;
+    agentTimestamp: string;
+    method: string;
+    path: string;
+    body?: string;
+    keytype?: string;
+    agentKey?: Hex;
+}
+export interface RegisterSelfAgentParams {
+    mode?: SelfRegistrationMode;
+    minimumAge?: 0 | 18 | 21;
+    ofac?: boolean;
+    humanAddress?: `0x${string}`;
+    agentName?: string;
+    agentDescription?: string;
+}
+export declare class SelfService {
+    private readonly clientFactory;
+    private readonly config;
+    constructor(clientFactory: CeloClientFactory, config: Pick<SdkConfig, "selfAgentPrivateKey" | "selfApiBase" | "attributionTags">);
+    private get apiBase();
+    private resolveAgentPrivateKey;
+    private registryClient;
+    private assertProofRefreshEligible;
+    verifyAgent(params: VerifySelfAgentParams): Promise<{
+        verified: boolean;
+        agent_address: `0x${string}`;
+        reason: string;
+        network: "mainnet";
+    } | {
+        verification_strength: string;
+        network: "mainnet";
+        sibling_agent_ids: number[];
+        proof_expires_at: string | null;
+        days_until_expiry: number;
+        is_expiring_soon: boolean;
+        verified: boolean;
+        agent_address: `0x${string}`;
+        agent_id: number;
+        reason: string;
+        credentials: {
+            nationality: string | undefined;
+            older_than: number;
+            ofac_clear: boolean;
+        };
+    } | {
+        verification_strength: string;
+        registered_at: number;
+        agent_count: number;
+        is_proof_fresh: boolean;
+        network: "mainnet";
+        sibling_agent_ids: number[];
+        proof_expires_at: string | null;
+        days_until_expiry: number;
+        is_expiring_soon: boolean;
+        verified: boolean;
+        agent_address: `0x${string}`;
+        agent_id: number;
+        credentials: {
+            nationality: string | undefined;
+            older_than: number;
+            ofac_clear: boolean;
+        };
+        reason?: undefined;
+    }>;
+    lookupAgent(agentId: number): Promise<{
+        is_expired: boolean;
+        network: "mainnet";
+        proof_expires_at: string | null;
+        days_until_expiry: number;
+        is_expiring_soon: boolean;
+        credentialsSummary: string;
+    }>;
+    verifyRequest(params: VerifySelfRequestParams): Promise<{
+        valid: boolean;
+        reason: string;
+        agent_address?: undefined;
+        agent_id?: undefined;
+        agent_count?: undefined;
+        nullifier?: undefined;
+        credentials?: undefined;
+        note?: undefined;
+    } | {
+        valid: boolean;
+        agent_address: `0x${string}`;
+        reason: string;
+        agent_id?: undefined;
+        agent_count?: undefined;
+        nullifier?: undefined;
+        credentials?: undefined;
+        note?: undefined;
+    } | {
+        valid: boolean;
+        agent_address: `0x${string}`;
+        agent_id: number;
+        reason: string;
+        agent_count?: undefined;
+        nullifier?: undefined;
+        credentials?: undefined;
+        note?: undefined;
+    } | {
+        valid: boolean;
+        agent_address: `0x${string}`;
+        agent_id: number;
+        agent_count: number;
+        nullifier: number;
+        credentials: {
+            nationality: string | undefined;
+            older_than: number;
+            ofac_clear: boolean;
+        };
+        note: string;
+        reason?: undefined;
+    }>;
+    private getAgentInfoFromKey;
+    getIdentity(): Promise<{
+        expiry_warning?: string | undefined;
+        is_expired: boolean;
+        sibling_agent_ids: number[];
+        network: "mainnet";
+        proof_expires_at: string | null;
+        days_until_expiry: number;
+        is_expiring_soon: boolean;
+        registered: true;
+        address: `0x${string}`;
+        agentKey: `0x${string}`;
+        agentId: number;
+        isVerified: boolean;
+        nullifier: number;
+        agentCount: number;
+        verificationStrength: string;
+        credentials_summary: string;
+    } | {
+        message: string;
+        registered: false;
+        address: `0x${string}`;
+        network: "mainnet";
+    }>;
+    registerAgent(params?: RegisterSelfAgentParams): Promise<{
+        session_id: string;
+        qr_code_url: string;
+        qr_url: string;
+        deep_link: string;
+        expires_at: string;
+        instructions: string;
+    }>;
+    checkRegistration(sessionId: string): Promise<{
+        status: "deregistered";
+        message: string;
+        proof_expires_at?: undefined;
+        agent_id?: undefined;
+        agent_address?: undefined;
+        private_key_hex?: undefined;
+        tx_hash?: undefined;
+    } | {
+        status: "refreshed";
+        proof_expires_at: string;
+        message: string;
+        agent_id?: undefined;
+        agent_address?: undefined;
+        private_key_hex?: undefined;
+        tx_hash?: undefined;
+    } | {
+        status: "verified";
+        agent_id: number;
+        agent_address: string;
+        private_key_hex: string;
+        tx_hash: string | undefined;
+        message: string;
+        proof_expires_at?: undefined;
+    } | {
+        status: "pending";
+        message: string;
+        proof_expires_at?: undefined;
+        agent_id?: undefined;
+        agent_address?: undefined;
+        private_key_hex?: undefined;
+        tx_hash?: undefined;
+    } | {
+        status: "expired";
+        message: string;
+        proof_expires_at?: undefined;
+        agent_id?: undefined;
+        agent_address?: undefined;
+        private_key_hex?: undefined;
+        tx_hash?: undefined;
+    }>;
+    refreshProof(params?: {
+        agentId?: number;
+    }): Promise<{
+        session_id: string;
+        qr_code_url: string;
+        qr_url: string;
+        deep_link: string;
+        expires_at: string;
+        instructions: string;
+    }>;
+    deregisterAgent(): Promise<{
+        session_id: string;
+        qr_code_url: string;
+        qr_url: string;
+        deep_link: string;
+        expires_at: string;
+        instructions: string;
+    }>;
+    signRequest(params: {
+        method: string;
+        url: string;
+        body?: string;
+    }): Promise<{
+        headers: {
+            "x-self-agent-address": `0x${string}`;
+            "x-self-agent-signature": `0x${string}`;
+            "x-self-agent-timestamp": string;
+        };
+        instructions: string;
+    }>;
+    authenticatedFetch(params: {
+        method: string;
+        url: string;
+        body?: string;
+        contentType?: string;
+    }): Promise<{
+        status: number;
+        body: string;
+        truncated: boolean;
+    }>;
+    /** Reserved for future on-chain Self writes (e.g. metadata updates). */
+    protected taggedCalldata(data: Hex): Hex;
+}