@terminal3/t3n-sdk 3.0.0 → 3.2.0

package/dist/src/client/actions.d.ts

@@ -20,3 +20,12 @@ export declare function createAuthAction(authInput: AuthInput): Uint8Array;
  * @param idToken - The id_token JWT obtained from the OIDC provider with the nonce
  */
 export declare function createOidcSubmitTokenAction(idToken: string): Uint8Array;
+/**
+ * Create the initial action for the ADD-authenticator flow: link a new
+ * Ethereum wallet to the session's already-authenticated DID. Drives
+ * the same client state machine as {@link createAuthAction} (eth), but
+ * the `AddAuthenticator` tag routes the server to the link path instead
+ * of resolve-or-mint. Only Ethereum is supported — OIDC/email identities
+ * are established at login, not added afterwards.
+ */
+export declare function createAddEthAuthAction(address: string): Uint8Array;

package/dist/src/client/t3n-client.d.ts

@@ -6,7 +6,7 @@
  */
 import { T3nClientConfig } from "./config";
 import { type ContractResponseSchema } from "./contract-response";
-import { SessionId, Did, SessionStatus, AuthInput, HandshakeResult } from "../types";
+import { SessionId, Did, SessionStatus, AuthInput, EthAuthInput, HandshakeResult } from "../types";
 import { KycPollOptions, KycStatus } from "../types/kyc";
 import { OtpChannel, OtpRequestInput, OtpRequestResult, OtpVerifyInput, OtpVerifyResult, SubmitUserInputArgs, SubmitUserInputResult } from "../types/user";
 import { GetUsageOptions, UsagePage } from "../types/token";
@@ -82,6 +82,27 @@ export declare class T3nClient {
      * 3. Sends `SubmitIdToken` with the nonce-bearing token → receives DID.
      */
     authenticate(authInput: AuthInput): Promise<Did>;
+    /**
+     * Add an Ethereum wallet as an additional authenticator on the
+     * already-authenticated account.
+     *
+     * Proves control of the wallet via SIWE and links it to the session's
+     * EXISTING DID (resolved server-side from the session) — it does NOT
+     * mint a new DID and does NOT change the session: `this.did` and
+     * `this.status` are left untouched, and no new cookie is issued.
+     *
+     * Requires a completed {@link authenticate} first (e.g. an OIDC
+     * login). Only Ethereum is supported — OIDC/email identities are
+     * established at login, not added afterwards.
+     *
+     * Reuses the same client-side eth state machine as login, but posts
+     * to the authenticated `auth.add-authenticator` route. If the wallet
+     * is already linked to a different account, the server rejects with a
+     * typed `eth_auth_map_conflict` error (resolve via account merge).
+     *
+     * @returns the existing DID the wallet was linked to.
+     */
+    addAuthMethod(authInput: EthAuthInput): Promise<Did>;
     /**
      * OIDC two-step authentication with session-binding nonce.
      *

package/dist/src/index.d.ts

@@ -20,6 +20,7 @@ export type { KycStatus, KycStatusKind, KycPollOptions, KycPollCadence, } from "
 export { DEFAULT_KYC_POLL_CADENCE, TERMINAL_KYC_STATUSES, KycStatusTimeoutError, } from "./types/kyc";
 export type { OtpChannel, OtpRequestInput, OtpRequestResult, OtpVerifyInput, OtpVerifyResult, OtpMergeSuggestion, UserInputProfile, SubmitUserInputArgs, SubmitUserInputResult, TenantAdmitProjection, TenantAdmitStatus, UserUpsertErrorKind, } from "./types/user";
 export { UserUpsertError } from "./types/user";
+export type { UsagePage, UsageEntry, GetUsageOptions, BalanceRow, TokenTxKind, Direction, ChargeReason, } from "./types/token";
 export { OrgDataClient, SessionOrgDataClient, createOrgDataClientFromSession, } from "./client/org-data";
 export type { OrgDataClientOptions, CreatePolicyInput, UpdateMetaInput, SetWritersInput, SetGrantsInput, DeleteGrantsInput, WriteDataInput, DeleteDataInput, DeleteScopeInput, PolicyGetInput, WritersGetInput, GrantsGetInput, DataListInput, DataGetInput, ExecuteOrgDataActionOptions, } from "./client/org-data";
 export type { OrgDataActionWire, OrgPolicyMeta, OrgWriters, OrgContractGrants, UserGrant, EmployeeRecord, EmploymentStatus, ResidencyCategory, AgeBand, ExpenseClaim, MutationResponse, DataListResponse, DataGetResponse, } from "./types/org-data";