ic-siwa 0.1.0

package/README.md

@@ -0,0 +1,213 @@
+# IC-SIWA TypeScript Library
+
+Sign in with Avalanche for the Internet Computer.
+
+## Installation
+
+```bash
+bun add ic-siwa
+# or
+npm install ic-siwa
+```
+
+## Quick Start
+
+```typescript
+import {SiwaClient} from "ic-siwa";
+import {createWalletClient, http} from "viem";
+import {avalanche} from "viem/chains";
+
+// Create SIWA client
+const siwa = new SiwaClient({
+  canisterId: "xxxxx-xxxxx-xxxxx-xxxxx-xxx",
+});
+
+// Create wallet client (using viem)
+const walletClient = createWalletClient({
+  chain: avalanche,
+  transport: http(),
+});
+
+// Login with wallet
+const result = await siwa.loginWithWallet(walletClient);
+console.log("Logged in as:", result.principal.toText());
+
+// Check if authenticated
+if (await siwa.isAuthenticated()) {
+  const principal = await siwa.getPrincipal();
+  console.log("Current principal:", principal?.toText());
+}
+
+// Make authenticated calls
+const actor = await siwa.createActor(canisterId, idlFactory);
+const data = await actor.getData();
+
+// Logout
+await siwa.logout();
+```
+
+## Manual Login Flow
+
+If you need more control over the login process:
+
+```typescript
+const siwa = new SiwaClient({
+  canisterId: "xxxxx-xxxxx-xxxxx-xxxxx-xxx",
+});
+
+// 1. Prepare login message
+const address = "0x1234...abcd";
+const prepared = await siwa.prepareLogin(address);
+
+// 2. Sign message with your wallet
+const signature = await wallet.signMessage(prepared.message);
+
+// 3. Complete login
+const result = await siwa.login(signature, address);
+```
+
+## Configuration Options
+
+```typescript
+const siwa = new SiwaClient({
+  // Required: IC-SIWA Provider canister ID
+  canisterId: "xxxxx-xxxxx-xxxxx-xxxxx-xxx",
+
+  // Optional: IC host (default: https://ic0.app)
+  host: "https://ic0.app",
+
+  // Optional: Custom storage provider (default: localStorage)
+  storage: new MemoryStorageProvider(),
+
+  // Optional: Auto-refresh delegation before expiry (default: true)
+  autoRefresh: true,
+});
+```
+
+## Storage Providers
+
+The library includes two storage providers:
+
+- `LocalStorageProvider` (default) - Persists identity in browser localStorage
+- `MemoryStorageProvider` - In-memory storage for testing or SSR
+
+You can also implement your own by implementing the `StorageProvider` interface.
+
+## Error Handling
+
+```typescript
+import {SiwaError, SiwaErrorCode} from "ic-siwa";
+
+try {
+  await siwa.login(signature, address);
+} catch (error) {
+  if (error instanceof SiwaError) {
+    switch (error.code) {
+      case SiwaErrorCode.InvalidSignature:
+        console.error("Invalid signature");
+        break;
+      case SiwaErrorCode.MessageExpired:
+        console.error("Login message expired");
+        break;
+      default:
+        console.error("Login failed:", error.message);
+    }
+  }
+}
+```
+
+## Astro Component
+
+The library includes a ready-to-use Astro component for the login button.
+
+### Basic Usage
+
+```astro
+---
+import LoginButton from 'ic-siwa/astro';
+---
+
+<LoginButton canisterId="xxxxx-xxxxx-xxxxx-xxxxx-xxx" />
+```
+
+### Props
+
+| Prop          | Type                                  | Default                  | Description                  |
+| ------------- | ------------------------------------- | ------------------------ | ---------------------------- |
+| `canisterId`  | `string`                              | required                 | IC-SIWA Provider canister ID |
+| `host`        | `string`                              | `https://ic0.app`        | IC host URL                  |
+| `label`       | `string`                              | `Sign in with Avalanche` | Button text                  |
+| `size`        | `xs\|sm\|md\|lg\|xl`                  | `md`                     | Button size                  |
+| `variant`     | `primary\|secondary\|accent\|neutral` | `primary`                | Color variant                |
+| `style`       | `solid\|outline\|soft\|ghost`         | `solid`                  | Button style                 |
+| `showAddress` | `boolean`                             | `true`                   | Show address when logged in  |
+| `class`       | `string`                              | `""`                     | Additional CSS classes       |
+| `id`          | `string`                              | `siwa-login-btn`         | Custom element ID            |
+
+### Custom Styling
+
+```astro
+<LoginButton
+  canisterId="xxxxx-xxxxx-xxxxx-xxxxx-xxx"
+  label="Connect Wallet"
+  variant="accent"
+  style="outline"
+  size="lg"
+  class="my-custom-class"
+/>
+```
+
+### Events
+
+The component emits custom events you can listen to:
+
+```astro
+---
+import LoginButton from 'ic-siwa/astro';
+---
+
+<div id="auth-container">
+  <LoginButton canisterId="xxxxx-xxxxx-xxxxx-xxxxx-xxx" />
+</div>
+
+<script>
+  const container = document.getElementById('auth-container');
+
+  container.addEventListener('siwa:login-start', () => {
+    console.log('Login started...');
+  });
+
+  container.addEventListener('siwa:login-success', (e) => {
+    console.log('Logged in as:', e.detail.principal);
+    console.log('Address:', e.detail.address);
+  });
+
+  container.addEventListener('siwa:login-error', (e) => {
+    console.error('Login failed:', e.detail.error);
+  });
+
+  container.addEventListener('siwa:logout', () => {
+    console.log('User logged out');
+  });
+</script>
+```
+
+### Custom Icon
+
+You can replace the default Avalanche logo with a custom icon:
+
+```astro
+<LoginButton canisterId="xxxxx-xxxxx-xxxxx-xxxxx-xxx">
+  <svg slot="icon" ...>...</svg>
+</LoginButton>
+```
+
+## Requirements
+
+- DaisyUI and Tailwind CSS for the Astro component styling
+- An Avalanche-compatible wallet (Core, MetaMask, etc.)
+- Deployed `ic_siwa_provider` canister
+
+## License
+
+MIT

package/dist/astro/index.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Astro components for IC-SIWA
+ *
+ * Usage:
+ * ```astro
+ * ---
+ * import { LoginButton } from 'ic-siwa/astro';
+ * ---
+ *
+ * <LoginButton canisterId="xxxxx-xxxxx-xxxxx-xxxxx-xxx" />
+ * ```
+ */
+export interface LoginButtonProps {
+    /** Canister ID of the ic_siwa_provider */
+    canisterId: string;
+    /** IC host URL (default: https://ic0.app) */
+    host?: string;
+    /** Button label text */
+    label?: string;
+    /** Button size: xs, sm, md, lg, xl */
+    size?: "xs" | "sm" | "md" | "lg" | "xl";
+    /** Button color variant */
+    variant?: "primary" | "secondary" | "accent" | "neutral";
+    /** Button style */
+    style?: "solid" | "outline" | "soft" | "ghost";
+    /** Additional CSS classes */
+    class?: string;
+    /** Show wallet address when logged in */
+    showAddress?: boolean;
+    /** Custom ID for the button element */
+    id?: string;
+}
+/**
+ * Custom events emitted by LoginButton:
+ *
+ * - `siwa:login-start` - Emitted when login process begins
+ * - `siwa:login-success` - Emitted on successful login
+ *   - detail: { principal: string, address: string }
+ * - `siwa:login-error` - Emitted on login failure
+ *   - detail: { error: string }
+ * - `siwa:logout` - Emitted when user logs out
+ *
+ * @example
+ * ```html
+ * <div id="login-container">
+ *   <LoginButton canisterId="..." />
+ * </div>
+ *
+ * <script>
+ *   document.getElementById('login-container')
+ *     .addEventListener('siwa:login-success', (e) => {
+ *       console.log('Logged in:', e.detail.principal);
+ *     });
+ * </script>
+ * ```
+ */
+export type LoginButtonEvents = {
+    "siwa:login-start": CustomEvent<void>;
+    "siwa:login-success": CustomEvent<{
+        principal: string;
+        address: string;
+    }>;
+    "siwa:login-error": CustomEvent<{
+        error: string;
+    }>;
+    "siwa:logout": CustomEvent<void>;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/astro/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/astro/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,MAAM,WAAW,gBAAgB;IAC/B,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IACxC,2BAA2B;IAC3B,OAAO,CAAC,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;IACzD,mBAAmB;IACnB,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;IAC/C,6BAA6B;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,uCAAuC;IACvC,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,kBAAkB,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;IACtC,oBAAoB,EAAE,WAAW,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAC,CAAC,CAAC;IACxE,kBAAkB,EAAE,WAAW,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAC,CAAC,CAAC;IACjD,aAAa,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;CAClC,CAAC"}

package/dist/astro/index.js

@@ -0,0 +1,14 @@
+/**
+ * Astro components for IC-SIWA
+ *
+ * Usage:
+ * ```astro
+ * ---
+ * import { LoginButton } from 'ic-siwa/astro';
+ * ---
+ *
+ * <LoginButton canisterId="xxxxx-xxxxx-xxxxx-xxxxx-xxx" />
+ * ```
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/astro/index.js.map

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

package/dist/candid/ic_siwa_provider.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Auto-generated Candid bindings for ic_siwa_provider canister
+ * Generated from: canisters/ic_siwa_provider/ic_siwa_provider.did
+ * DO NOT EDIT MANUALLY - regenerate with: ic-siwa candid
+ */
+import type { Principal } from '@dfinity/principal';
+import type { ActorMethod } from '@dfinity/agent';
+export interface Delegation {
+    'pubkey': Uint8Array | number[];
+    'targets': [] | [Array<Principal>];
+    'expiration': bigint;
+}
+export interface InitArgs {
+    'uri': string;
+    'domain': string;
+    'salt': string;
+    'chain_id': bigint;
+    'allowed_domains': [] | [Array<string>];
+    'allowed_canisters': [] | [Array<Principal>];
+    'session_expiration_time': bigint;
+}
+export interface LoginResponse {
+    'user_principal': Principal;
+    'expiration': bigint;
+}
+export interface PrepareLoginResponse {
+    'expiration': bigint;
+    'message': string;
+    'nonce': string;
+}
+export type Result = {
+    'Ok': string;
+} | {
+    'Err': string;
+};
+export type Result_1 = {
+    'Ok': Principal;
+} | {
+    'Err': string;
+};
+export type Result_2 = {
+    'Ok': SignedDelegation;
+} | {
+    'Err': string;
+};
+export type Result_3 = {
+    'Ok': LoginResponse;
+} | {
+    'Err': string;
+};
+export type Result_4 = {
+    'Ok': PrepareLoginResponse;
+} | {
+    'Err': string;
+};
+export interface SignedDelegation {
+    'signature': Uint8Array | number[];
+    'delegation': Delegation;
+}
+export interface _SERVICE {
+    /**
+     * Get Avalanche address for ICP principal
+     */
+    'get_address': ActorMethod<[Principal], Result>;
+    /**
+     * Get Avalanche address for caller
+     */
+    'get_caller_address': ActorMethod<[], Result>;
+    /**
+     * Get ICP principal for Avalanche address
+     */
+    'get_principal': ActorMethod<[string], Result_1>;
+    /**
+     * Get delegation for authenticated principal
+     *
+     * # Arguments
+     * * `address` - The Avalanche address
+     * * `session_key` - The session public key from login
+     * * `expiration` - Requested expiration timestamp (may be capped)
+     *
+     * # Returns
+     * * `Ok(SignedDelegation)` - The signed delegation for the session
+     * * `Err(String)` - Error if not authenticated or expired
+     */
+    'siwa_get_delegation': ActorMethod<[
+        string,
+        Uint8Array | number[],
+        bigint
+    ], Result_2>;
+    /**
+     * Complete SIWA login with signed message
+     *
+     * # Arguments
+     * * `signature` - Hex-encoded signature from the user's wallet
+     * * `address` - The Avalanche address that signed the message
+     * * `session_key` - The session public key to bind to this authentication
+     *
+     * # Returns
+     * * `Ok(LoginResponse)` - The derived principal and session expiration
+     * * `Err(String)` - Error if signature is invalid or session expired
+     */
+    'siwa_login': ActorMethod<[string, string, Uint8Array | number[]], Result_3>;
+    /**
+     * Prepare a SIWA login message for signing
+     *
+     * # Arguments
+     * * `address` - The Avalanche address (0x-prefixed, EIP-55 checksummed)
+     *
+     * # Returns
+     * * `Ok(PrepareLoginResponse)` - The message to sign, nonce, and expiration
+     * * `Err(String)` - Error description if address is invalid
+     */
+    'siwa_prepare_login': ActorMethod<[string], Result_4>;
+}
+export declare const idlFactory: ({ IDL }: {
+    IDL: any;
+}) => any;
+export declare const init: ({ IDL }: {
+    IDL: any;
+}) => any[];
+//# sourceMappingURL=ic_siwa_provider.d.ts.map

package/dist/candid/ic_siwa_provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ic_siwa_provider.d.ts","sourceRoot":"","sources":["../../src/candid/ic_siwa_provider.ts"],"names":[],"mappings":"AACA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAGlD,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAG,UAAU,GAAG,MAAM,EAAE,CAAC;IACjC,SAAS,EAAG,EAAE,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;IACpC,YAAY,EAAG,MAAM,CAAC;CACvB;AACD,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAG,MAAM,CAAC;IACf,QAAQ,EAAG,MAAM,CAAC;IAClB,MAAM,EAAG,MAAM,CAAC;IAChB,UAAU,EAAG,MAAM,CAAC;IACpB,iBAAiB,EAAG,EAAE,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IACzC,mBAAmB,EAAG,EAAE,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;IAC9C,yBAAyB,EAAG,MAAM,CAAC;CACpC;AACD,MAAM,WAAW,aAAa;IAC5B,gBAAgB,EAAG,SAAS,CAAC;IAC7B,YAAY,EAAG,MAAM,CAAC;CACvB;AACD,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAG,MAAM,CAAC;IACtB,SAAS,EAAG,MAAM,CAAC;IACnB,OAAO,EAAG,MAAM,CAAC;CAClB;AACD,MAAM,MAAM,MAAM,GAAG;IAAE,IAAI,EAAG,MAAM,CAAA;CAAE,GACpC;IAAE,KAAK,EAAG,MAAM,CAAA;CAAE,CAAC;AACrB,MAAM,MAAM,QAAQ,GAAG;IAAE,IAAI,EAAG,SAAS,CAAA;CAAE,GACzC;IAAE,KAAK,EAAG,MAAM,CAAA;CAAE,CAAC;AACrB,MAAM,MAAM,QAAQ,GAAG;IAAE,IAAI,EAAG,gBAAgB,CAAA;CAAE,GAChD;IAAE,KAAK,EAAG,MAAM,CAAA;CAAE,CAAC;AACrB,MAAM,MAAM,QAAQ,GAAG;IAAE,IAAI,EAAG,aAAa,CAAA;CAAE,GAC7C;IAAE,KAAK,EAAG,MAAM,CAAA;CAAE,CAAC;AACrB,MAAM,MAAM,QAAQ,GAAG;IAAE,IAAI,EAAG,oBAAoB,CAAA;CAAE,GACpD;IAAE,KAAK,EAAG,MAAM,CAAA;CAAE,CAAC;AACrB,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAG,UAAU,GAAG,MAAM,EAAE,CAAC;IACpC,YAAY,EAAG,UAAU,CAAC;CAC3B;AACD,MAAM,WAAW,QAAQ;IACvB;;OAEG;IACH,aAAa,EAAG,WAAW,CAAC,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,CAAC;IACjD;;OAEG;IACH,oBAAoB,EAAG,WAAW,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IAC/C;;OAEG;IACH,eAAe,EAAG,WAAW,CAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,CAAC;IAClD;;;;;;;;;;;OAWG;IACH,qBAAqB,EAAG,WAAW,CACjC;QAAC,MAAM;QAAE,UAAU,GAAG,MAAM,EAAE;QAAE,MAAM;KAAC,EACvC,QAAQ,CACT,CAAC;IACF;;;;;;;;;;;OAWG;IACH,YAAY,EAAG,WAAW,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC9E;;;;;;;;;OASG;IACH,oBAAoB,EAAG,WAAW,CAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,CAAC;CACxD;AAED,eAAO,MAAM,UAAU,GAAI,SAAS;IAAE,GAAG,EAAE,GAAG,CAAA;CAAE,QAoD/C,CAAC;AACF,eAAO,MAAM,IAAI,GAAI,SAAS;IAAE,GAAG,EAAE,GAAG,CAAA;CAAE,UAWzC,CAAC"}

package/dist/candid/ic_siwa_provider.js

@@ -0,0 +1,64 @@
+// @ts-nocheck
+/**
+ * Auto-generated Candid bindings for ic_siwa_provider canister
+ * Generated from: canisters/ic_siwa_provider/ic_siwa_provider.did
+ * DO NOT EDIT MANUALLY - regenerate with: ic-siwa candid
+ */
+export const idlFactory = ({ IDL }) => {
+    const InitArgs = IDL.Record({
+        'uri': IDL.Text,
+        'domain': IDL.Text,
+        'salt': IDL.Text,
+        'chain_id': IDL.Nat64,
+        'allowed_domains': IDL.Opt(IDL.Vec(IDL.Text)),
+        'allowed_canisters': IDL.Opt(IDL.Vec(IDL.Principal)),
+        'session_expiration_time': IDL.Nat64,
+    });
+    const Result = IDL.Variant({ 'Ok': IDL.Text, 'Err': IDL.Text });
+    const Result_1 = IDL.Variant({ 'Ok': IDL.Principal, 'Err': IDL.Text });
+    const Delegation = IDL.Record({
+        'pubkey': IDL.Vec(IDL.Nat8),
+        'targets': IDL.Opt(IDL.Vec(IDL.Principal)),
+        'expiration': IDL.Nat64,
+    });
+    const SignedDelegation = IDL.Record({
+        'signature': IDL.Vec(IDL.Nat8),
+        'delegation': Delegation,
+    });
+    const Result_2 = IDL.Variant({ 'Ok': SignedDelegation, 'Err': IDL.Text });
+    const LoginResponse = IDL.Record({
+        'user_principal': IDL.Principal,
+        'expiration': IDL.Nat64,
+    });
+    const Result_3 = IDL.Variant({ 'Ok': LoginResponse, 'Err': IDL.Text });
+    const PrepareLoginResponse = IDL.Record({
+        'expiration': IDL.Nat64,
+        'message': IDL.Text,
+        'nonce': IDL.Text,
+    });
+    const Result_4 = IDL.Variant({
+        'Ok': PrepareLoginResponse,
+        'Err': IDL.Text,
+    });
+    return IDL.Service({
+        'get_address': IDL.Func([IDL.Principal], [Result], ['query']),
+        'get_caller_address': IDL.Func([], [Result], ['query']),
+        'get_principal': IDL.Func([IDL.Text], [Result_1], ['query']),
+        'siwa_get_delegation': IDL.Func([IDL.Text, IDL.Vec(IDL.Nat8), IDL.Nat64], [Result_2], ['query']),
+        'siwa_login': IDL.Func([IDL.Text, IDL.Text, IDL.Vec(IDL.Nat8)], [Result_3], []),
+        'siwa_prepare_login': IDL.Func([IDL.Text], [Result_4], []),
+    });
+};
+export const init = ({ IDL }) => {
+    const InitArgs = IDL.Record({
+        'uri': IDL.Text,
+        'domain': IDL.Text,
+        'salt': IDL.Text,
+        'chain_id': IDL.Nat64,
+        'allowed_domains': IDL.Opt(IDL.Vec(IDL.Text)),
+        'allowed_canisters': IDL.Opt(IDL.Vec(IDL.Principal)),
+        'session_expiration_time': IDL.Nat64,
+    });
+    return [InitArgs];
+};
+//# sourceMappingURL=ic_siwa_provider.js.map

package/dist/candid/ic_siwa_provider.js.map

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

package/dist/candid/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Candid TypeScript declarations
+ * Auto-generated - DO NOT EDIT MANUALLY
+ */
+export * from './ic_siwa_provider';
+//# sourceMappingURL=index.d.ts.map

package/dist/candid/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/candid/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,oBAAoB,CAAC"}

package/dist/candid/index.js

@@ -0,0 +1,6 @@
+/**
+ * Candid TypeScript declarations
+ * Auto-generated - DO NOT EDIT MANUALLY
+ */
+export * from './ic_siwa_provider';
+//# sourceMappingURL=index.js.map

package/dist/candid/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/candid/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,oBAAoB,CAAC"}

package/dist/client.d.ts

@@ -0,0 +1,124 @@
+/**
+ * SIWA Client for browser-based authentication
+ */
+import { HttpAgent } from "@dfinity/agent";
+import { Ed25519KeyIdentity } from "@dfinity/identity";
+import { Principal } from "@dfinity/principal";
+import { type SiwaIdentity } from "./identity";
+import { type StorageProvider } from "./storage";
+import type { PreparedLogin, LoginResult } from "./types";
+/**
+ * SIWA Client configuration options
+ */
+export interface SiwaClientOptions {
+    /** Canister ID of the ic_siwa_provider */
+    canisterId: string;
+    /** IC host URL (default: https://ic0.app) */
+    host?: string;
+    /** Storage provider for caching identity (default: localStorage) */
+    storage?: StorageProvider;
+    /** Auto-refresh delegation before expiry */
+    autoRefresh?: boolean;
+    /** Refresh threshold in milliseconds (default: 5 minutes before expiry) */
+    refreshThreshold?: number;
+}
+/**
+ * SIWA Client for authenticating with Avalanche wallets
+ */
+export declare class SiwaClient {
+    private canisterId;
+    private host;
+    private storage;
+    private autoRefresh;
+    private refreshThreshold;
+    private identity;
+    private agent;
+    private refreshTimer;
+    private sessionKey;
+    constructor(options: SiwaClientOptions);
+    /**
+     * Check if user is currently authenticated
+     */
+    isAuthenticated(): Promise<boolean>;
+    /**
+     * Get the current identity if authenticated
+     */
+    getIdentity(): Promise<SiwaIdentity | null>;
+    /**
+     * Get the current principal if authenticated
+     */
+    getPrincipal(): Promise<Principal | null>;
+    /**
+     * Get the current Avalanche address if authenticated
+     */
+    getAddress(): Promise<string | null>;
+    /**
+     * Create an anonymous agent for canister calls
+     */
+    private createAnonymousAgent;
+    /**
+     * Create an actor for the SIWA provider canister
+     */
+    private createProviderActor;
+    /**
+     * Prepare a login message for signing
+     */
+    prepareLogin(address: string): Promise<PreparedLogin>;
+    /**
+     * Complete login with signed message
+     *
+     * @param signature - The signed message from the wallet
+     * @param address - The Avalanche address
+     * @param sessionKey - Optional session key (generated if not provided)
+     */
+    login(signature: string, address: string, sessionKey?: Ed25519KeyIdentity): Promise<LoginResult>;
+    /**
+     * Build delegation chain from canister response
+     *
+     * @param candidDelegation - Delegation record from canister
+     * @param signatureBytes - Signature from canister
+     */
+    private buildDelegationChain;
+    /**
+     * Refresh the current delegation
+     */
+    refreshDelegation(): Promise<LoginResult | null>;
+    /**
+     * Schedule automatic delegation refresh
+     */
+    private scheduleRefresh;
+    /**
+     * Login with a wallet client (convenience method)
+     *
+     * @param walletClient - A viem wallet client or similar
+     */
+    loginWithWallet(walletClient: {
+        account: {
+            address: string;
+        };
+        signMessage: (args: {
+            message: string;
+        }) => Promise<string>;
+    }): Promise<LoginResult>;
+    /**
+     * Logout and clear stored identity
+     */
+    logout(): Promise<void>;
+    /**
+     * Get an HttpAgent for making authenticated calls
+     */
+    getAgent(): Promise<HttpAgent>;
+    /**
+     * Create an actor for calling a canister
+     */
+    createActor<T>(canisterId: string | Principal, idlFactory: unknown): Promise<T>;
+    /**
+     * Get the canister ID
+     */
+    getCanisterId(): Principal;
+    /**
+     * Get the host URL
+     */
+    getHost(): string;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAQ,SAAS,EAAgC,MAAM,gBAAgB,CAAC;AAC/E,OAAO,EAGL,kBAAkB,EACnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAC,SAAS,EAAC,MAAM,oBAAoB,CAAC;AAU7C,OAAO,EAGL,KAAK,YAAY,EAElB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAuB,KAAK,eAAe,EAAC,MAAM,WAAW,CAAC;AACrE,OAAO,KAAK,EAAC,aAAa,EAAE,WAAW,EAAC,MAAM,SAAS,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,4CAA4C;IAC5C,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,2EAA2E;IAC3E,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,UAAU,CAAY;IAC9B,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,WAAW,CAAU;IAC7B,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,YAAY,CAA8C;IAClE,OAAO,CAAC,UAAU,CAAmC;gBAEzC,OAAO,EAAE,iBAAiB;IAQtC;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IAKzC;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAoCjD;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAK/C;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAK1C;;OAEG;YACW,oBAAoB;IAiBlC;;OAEG;YACW,mBAAmB;IAQjC;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IA6B3D;;;;;;OAMG;IACG,KAAK,CACT,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,kBAAkB,GAC9B,OAAO,CAAC,WAAW,CAAC;IA4GvB;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;IA8C5B;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IA8EtD;;OAEG;IACH,OAAO,CAAC,eAAe;IAuBvB;;;;OAIG;IACG,eAAe,CAAC,YAAY,EAAE;QAClC,OAAO,EAAE;YAAC,OAAO,EAAE,MAAM,CAAA;SAAC,CAAC;QAC3B,WAAW,EAAE,CAAC,IAAI,EAAE;YAAC,OAAO,EAAE,MAAM,CAAA;SAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;KAC3D,GAAG,OAAO,CAAC,WAAW,CAAC;IAexB;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAe7B;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,SAAS,CAAC;IAyBpC;;OAEG;IACG,WAAW,CAAC,CAAC,EACjB,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,UAAU,EAAE,OAAO,GAClB,OAAO,CAAC,CAAC,CAAC;IAWb;;OAEG;IACH,aAAa,IAAI,SAAS;IAI1B;;OAEG;IACH,OAAO,IAAI,MAAM;CAGlB"}