@terminal3/t3n-sdk 0.14.0 → 1.0.0

package/dist/index.d.ts

@@ -745,6 +745,24 @@ declare class T3nClient {
      * @throws {ContractResponseError} when the response is not valid JSON
      */
     executeAndDecode<T = unknown>(payload: unknown, schema?: ContractResponseSchema<T>): Promise<T>;
+    /**
+     * Return the authenticated user's Ethereum address from their
+     * T3N-hosted per-user wallet, as a 0x-prefixed lowercase hex string.
+     * Returns `null` if the user has no wallet yet (pre-backfill edge
+     * case — `tee:user` has not yet been migrated for this DID).
+     *
+     * Backed by the `tee:user/get-self-eth-address` contract function,
+     * which delegates to the signing host's `get-user-eth-address`
+     * primitive (T3-TS-027 §7.1). The request carries no body; the
+     * authenticated user's DID is read from session context by the host.
+     *
+     * Requires the session to be Authenticated (same precondition as
+     * {@link execute}).
+     *
+     * @throws if unauthenticated, if the node rejects the action, or if
+     *   the response is not a JSON string / `null`.
+     */
+    getSelfEthAddress(): Promise<string | null>;
     /**
      * The server-minted session ID once handshake has completed, or
      * `null` beforehand (pentest M-1 / MAT-983).