accounts 0.2.1 → 0.4.0

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# accounts
+
+## 0.4.0
+
+### Minor Changes
+
+- f257ccc: Initial release.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026-present weth, LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,97 +1,97 @@
-# node-accounts
+# Tempo Accounts SDK
 
-**accounts** is a simple User Management module for Node.js.
+Accounts SDK for Tempo Wallets & Apps.
 
-Current version supports logins only with providers(Google, Yahoo, Facebook, etc.).
+## Install
+
+```sh
+pnpm i accounts
+```
 
 ## Usage
 
-All you need to do is to create an application, and then use appId for managing users.
+### Vanilla JS
 
-#### Create a new app
-```
-var Accounts = require('accounts')(storage, options);
-var appId;
-
-Accounts.apps.create({
-    name: 'Test app'
-  }).then(function(app) {
-    appId = app.id;
-  });
-```
+You can get set up with the Accounts SDK with pure JavaScript by using the
+`Provider` instance.
 
-#### Provider login
-```
-var Accounts = require('accounts')(storage);
-var appId = process.env.ACCOUNTS_APP_ID;
-var App = Accounts.app(appId);
-
-App.login('social', profile)
-  .then(function(user) {
-    if (user) {
-      console.log(user);
-    }
-    else {
-      console.log('login faild');
-    }
-  });
-```
-Where `Profile` is a Passport [User Profile](http://passportjs.org/guide/profile/)
-```
-var profile = {
-  provider: 'facebook',
-  id: '123124234235123',
-  displayName: 'Dumitru K',
-  accessData: {
-    accessToken:'dsgsgs', refreshToken:'gerge'
-  }
-};
-```
+Internally, the `Provider` utilizes [EIP-6963](https://eips.ethereum.org/EIPS/eip-6963) to inject it's provider instance into
+the page so it can be picked up by wallet connection dialogs on external web applications.
 
-## API
+```tsx
+import { Provider } from 'accounts'
 
-### (storage, options)
+const provider = Provider.create()
 
-Creates a new Client.
+const { accounts } = await provider.request({
+  method: 'wallet_connect',
+})
+```
 
-## Client API
+### Viem
 
-### admin
+The Provider provides a Viem Client instance via the `getClient` accessor.
 
-- **sync**() - Syncronize DB tables.
-- **drop**(secret) - Drop DB tables. Useful for tests.
+```tsx
+import { Provider } from 'accounts'
 
-### apps
+const provider = Provider.create()
 
-- **create**(data) - Create a new application.
-- **getById**(id) - Get an application by id.
+const client = provider.getClient()
+```
 
-### app(appId)
+### Wagmi
 
-Creates a new Application Client for a given app id.
+Use the `tempoWallet` Wagmi connector to allow your Wagmi application to enable the Tempo Wallet dialog.
 
-## Application Client API
+```tsx
+import { createConfig, http } from 'wagmi'
+import { tempo } from 'wagmi/chains'
+import { tempoWallet } from 'accounts/wagmi'
 
-### login(type, data, options) - User login.
+export const wagmiConfig = createConfig({
+  chains: [tempo],
+  connectors: [tempoWallet()],
+  transports: {
+    [tempo.id]: http(),
+  },
+})
+```
 
-### users
+## Adapters
+
+| Adapter                  | Description                                                                        |
+| ------------------------ | ---------------------------------------------------------------------------------- |
+| `dialog` / `tempoWallet` | Adapter for the Tempo Wallet dialog (an embedded iframe/popup dialog).             |
+| `webAuthn`               | App-bound passkey accounts using WebAuthn registration and authentication flows.   |
+| `local`                  | Key agnostic adapter to define arbitrary account/key types and signing mechanisms. |
+
+## Development
+
+```sh
+pnpm dev              # start embed + embed-ref + playground dev servers
+pnpm dev:embed        # start Tempo Wallet embed only
+pnpm dev:embed-ref    # start reference embed implementation only (port 5174)
+pnpm dev:playground   # start playground app only
+pnpm dev:hosts        # start embed + playground instances on different TLDs
+pnpm build            # build library
+pnpm check            # lint + format
+pnpm check:types      # type checks
+pnpm test             # run tests
+```
 
-- **create**(data, options) - Create a new user.
-- **getById**(id, options) - Get an user object by id.
-- **update**(data, options) - Update user fields.
-- **deleteById**(id, options) - Delete an user by id.
+> `pnpm dev:hosts` starts three dev servers on different domains for cross-origin testing:
+>
+> - `https://app.moderato.tempo.local:3001`
+> - `https://playground.a:5173`
+> - `https://playground.b:5175`
 
-### identities
+### Embed Reference Implementation
 
-- **create**(data, options) - Create a new identity.
-- **getById**(id, options) - Get an user identity by id.
-- **findByUserId**(userId, options) - Find user identities by user id.
-- **update**(data, options) - Update an identity.
-- **deleteById**(id, options) - Delete an user identity by id.
-- **deleteByUserId**(userId, options) - Delete user identities by user id.
+The `embed-ref/` directory contains a minimal, unstyled reference implementation of the embed dialog app. It demonstrates how to build a custom embed using the Account SDK's `Remote` API.
 
+Select `dialogRefImpl` in the playground's adapter dropdown to test against it.
 
-## Storages
+## License
 
-- DynamoDB: [dynamo-accounts](https://github.com/Mitica/dynamo-accounts);
-- MongoDB: [mongo-accounts](https://github.com/Mitica/mongo-accounts);
+MIT

package/dist/core/AccessKey.d.ts

@@ -0,0 +1,55 @@
+import { Address, WebCryptoP256 } from 'ox';
+import { KeyAuthorization } from 'ox/tempo';
+import { Account as TempoAccount } from 'viem/tempo';
+import type * as Store from './Store.js';
+/** Returns the pending key authorization for an access key account without removing it. */
+export declare function getPending(account: TempoAccount.Account, options: {
+    store: Store.Store;
+}): KeyAuthorization.Signed | undefined;
+/** Generates a P256 key pair and access key account. */
+export declare function generate(options?: generate.Options): Promise<generate.ReturnType>;
+export declare namespace generate {
+    type Options = {
+        /** Root account to attach to the access key. */
+        account?: TempoAccount.Account | undefined;
+    };
+    type ReturnType = {
+        /** The generated access key account. */
+        accessKey: TempoAccount.AccessKeyAccount;
+        /** Generated key pair to pass to `authorizeAccessKey`. */
+        keyPair: Awaited<globalThis.ReturnType<typeof WebCryptoP256.createKeyPair>>;
+    };
+}
+/** Removes an access key entry for the given account from the store. */
+export declare function remove(account: TempoAccount.Account, options: {
+    store: Store.Store;
+}): void;
+/** Permanently removes the pending key authorization for an access key account. */
+export declare function removePending(account: TempoAccount.Account, options: {
+    store: Store.Store;
+}): void;
+/** Removes an access key from the store. */
+export declare function revoke(options: revoke.Options): void;
+export declare namespace revoke {
+    type Options = {
+        /** Root account address. */
+        address: Address.Address;
+        /** Reactive state store. */
+        store: Store.Store;
+    };
+}
+/** Saves an access key to the store with its one-time key authorization. */
+export declare function save(options: save.Options): void;
+export declare namespace save {
+    type Options = {
+        /** Root account address that owns this access key. */
+        address: Address.Address;
+        /** Signed key authorization to attach to the first transaction. */
+        keyAuthorization: KeyAuthorization.Signed;
+        /** The WebCrypto key pair backing the access key. Only present for locally-generated keys. */
+        keyPair?: Awaited<ReturnType<typeof WebCryptoP256.createKeyPair>> | undefined;
+        /** Reactive state store. */
+        store: Store.Store;
+    };
+}
+//# sourceMappingURL=AccessKey.d.ts.map

package/dist/core/AccessKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AccessKey.d.ts","sourceRoot":"","sources":["../../src/core/AccessKey.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,IAAI,CAAA;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAC3C,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,YAAY,CAAA;AAEpD,OAAO,KAAK,KAAK,KAAK,MAAM,YAAY,CAAA;AAExC,2FAA2F;AAC3F,wBAAgB,UAAU,CACxB,OAAO,EAAE,YAAY,CAAC,OAAO,EAC7B,OAAO,EAAE;IAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAA;CAAE,GAC9B,gBAAgB,CAAC,MAAM,GAAG,SAAS,CAOrC;AAED,wDAAwD;AACxD,wBAAsB,QAAQ,CAAC,OAAO,GAAE,QAAQ,CAAC,OAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAQ3F;AAED,MAAM,CAAC,OAAO,WAAW,QAAQ,CAAC;IAChC,KAAK,OAAO,GAAG;QACb,gDAAgD;QAChD,OAAO,CAAC,EAAE,YAAY,CAAC,OAAO,GAAG,SAAS,CAAA;KAC3C,CAAA;IAED,KAAK,UAAU,GAAG;QAChB,wCAAwC;QACxC,SAAS,EAAE,YAAY,CAAC,gBAAgB,CAAA;QACxC,0DAA0D;QAC1D,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,OAAO,aAAa,CAAC,aAAa,CAAC,CAAC,CAAA;KAC5E,CAAA;CACF;AAED,wEAAwE;AACxE,wBAAgB,MAAM,CAAC,OAAO,EAAE,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAA;CAAE,GAAG,IAAI,CAS3F;AAED,mFAAmF;AACnF,wBAAgB,aAAa,CAC3B,OAAO,EAAE,YAAY,CAAC,OAAO,EAC7B,OAAO,EAAE;IAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAA;CAAE,GAC9B,IAAI,CAWN;AAED,4CAA4C;AAC5C,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAMpD;AAED,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,KAAK,OAAO,GAAG;QACb,4BAA4B;QAC5B,OAAO,EAAE,OAAO,CAAC,OAAO,CAAA;QACxB,4BAA4B;QAC5B,KAAK,EAAE,KAAK,CAAC,KAAK,CAAA;KACnB,CAAA;CACF;AAED,4EAA4E;AAC5E,wBAAgB,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,GAAG,IAAI,CAiBhD;AAED,MAAM,CAAC,OAAO,WAAW,IAAI,CAAC;IAC5B,KAAK,OAAO,GAAG;QACb,sDAAsD;QACtD,OAAO,EAAE,OAAO,CAAC,OAAO,CAAA;QACxB,mEAAmE;QACnE,gBAAgB,EAAE,gBAAgB,CAAC,MAAM,CAAA;QACzC,8FAA8F;QAC9F,OAAO,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,aAAa,CAAC,aAAa,CAAC,CAAC,GAAG,SAAS,CAAA;QAC7E,4BAA4B;QAC5B,KAAK,EAAE,KAAK,CAAC,KAAK,CAAA;KACnB,CAAA;CACF"}

package/dist/core/AccessKey.js

@@ -0,0 +1,69 @@
+import { Address, WebCryptoP256 } from 'ox';
+import { KeyAuthorization } from 'ox/tempo';
+import { Account as TempoAccount } from 'viem/tempo';
+/** Returns the pending key authorization for an access key account without removing it. */
+export function getPending(account, options) {
+    if (account.source !== 'accessKey')
+        return undefined;
+    const { store } = options;
+    const accessKeyAddress = account.accessKeyAddress;
+    const { accessKeys } = store.getState();
+    const entry = accessKeys.find((a) => a.address?.toLowerCase() === accessKeyAddress.toLowerCase());
+    return entry?.keyAuthorization;
+}
+/** Generates a P256 key pair and access key account. */
+export async function generate(options = {}) {
+    const { account } = options;
+    const keyPair = await WebCryptoP256.createKeyPair();
+    const accessKey = TempoAccount.fromWebCryptoP256(keyPair, account ? { access: account } : undefined);
+    return { accessKey, keyPair };
+}
+/** Removes an access key entry for the given account from the store. */
+export function remove(account, options) {
+    if (account.source !== 'accessKey')
+        return;
+    const { store } = options;
+    const accessKeyAddress = account.accessKeyAddress;
+    store.setState((state) => ({
+        accessKeys: state.accessKeys.filter((a) => a.address?.toLowerCase() !== accessKeyAddress?.toLowerCase()),
+    }));
+}
+/** Permanently removes the pending key authorization for an access key account. */
+export function removePending(account, options) {
+    if (account.source !== 'accessKey')
+        return;
+    const { store } = options;
+    const accessKeyAddress = account.accessKeyAddress;
+    store.setState((state) => ({
+        accessKeys: state.accessKeys.map((a) => a.address.toLowerCase() === accessKeyAddress.toLowerCase()
+            ? { ...a, keyAuthorization: undefined }
+            : a),
+    }));
+}
+/** Removes an access key from the store. */
+export function revoke(options) {
+    const { address, store } = options;
+    const { accessKeys } = store.getState();
+    store.setState({
+        accessKeys: accessKeys.filter((a) => a.access.toLowerCase() !== address.toLowerCase()),
+    });
+}
+/** Saves an access key to the store with its one-time key authorization. */
+export function save(options) {
+    const { address, keyAuthorization, keyPair, store } = options;
+    store.setState((state) => ({
+        accessKeys: [
+            {
+                address: keyAuthorization.address,
+                access: address,
+                expiry: keyAuthorization.expiry ?? undefined,
+                keyAuthorization,
+                keyType: keyAuthorization.type,
+                limits: keyAuthorization.limits,
+                ...(keyPair ? { keyPair } : {}),
+            },
+            ...state.accessKeys,
+        ],
+    }));
+}
+//# sourceMappingURL=AccessKey.js.map

package/dist/core/AccessKey.js.map

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

package/dist/core/Account.d.ts

@@ -0,0 +1,91 @@
+import { type WebCryptoP256 } from 'ox';
+import { type KeyAuthorization } from 'ox/tempo';
+import type { Hex } from 'viem';
+import type { Address, JsonRpcAccount } from 'viem/accounts';
+import { Account as TempoAccount } from 'viem/tempo';
+import type { OneOf } from '../internal/types.js';
+import type * as core_Store from './Store.js';
+/** Account stored in the provider state. */
+export type Store = {
+    /** Account address. */
+    address: Address;
+} & OneOf<{} | Pick<TempoAccount.Account, 'keyType' | 'sign'> | {
+    keyType: 'secp256k1';
+    privateKey: Hex;
+} | {
+    keyType: 'p256';
+    privateKey: Hex;
+} | {
+    keyType: 'webAuthn';
+    credential: {
+        id: string;
+        publicKey: Hex;
+        rpId: string;
+    };
+} | {
+    keyType: 'webCrypto';
+    keyPair: Awaited<ReturnType<typeof WebCryptoP256.createKeyPair>>;
+} | {
+    keyType: 'webAuthn_headless';
+    privateKey: Hex;
+    rpId: string;
+    origin: string;
+}>;
+/** Access key entry stored alongside accounts. */
+export type AccessKey = {
+    /** Access key address. */
+    address: Address;
+    /** Owner of the access key. */
+    access: Address;
+    /** Unix timestamp when the access key expires. */
+    expiry?: number | undefined;
+    /** Signed key authorization to attach to the first transaction. Consumed on use. */
+    keyAuthorization?: KeyAuthorization.Signed | undefined;
+    /** The WebCrypto key pair backing the access key. Only present for locally-generated keys. */
+    keyPair?: Awaited<ReturnType<typeof WebCryptoP256.createKeyPair>> | undefined;
+    /** Key type. */
+    keyType: 'secp256k1' | 'p256' | 'webAuthn' | 'webCrypto';
+    /** TIP-20 spending limits for the access key. */
+    limits?: {
+        token: Address;
+        limit: bigint;
+    }[] | undefined;
+};
+/** Resolves a viem Account from the store by address (or active account). */
+export declare function find(options: find.Options & {
+    signable: true;
+}): TempoAccount.Account;
+export declare function find(options: find.Options): TempoAccount.Account | JsonRpcAccount;
+export declare namespace find {
+    type Options = {
+        /** Whether to resolve an access key for this account. @default true */
+        accessKey?: boolean | undefined;
+        /** Address to resolve. Defaults to the active account. */
+        address?: Address | undefined;
+        /** Whether to hydrate signing capability. @default false */
+        signable?: boolean | undefined;
+        /** Reactive state store. */
+        store: core_Store.Store;
+    };
+}
+/** Overloaded signature for `find` without `store` (pre-bound by the provider). */
+export type Find = {
+    (options: Omit<find.Options, 'store'> & {
+        signable: true;
+    }): TempoAccount.Account;
+    (options?: Omit<find.Options, 'store'>): TempoAccount.Account | JsonRpcAccount;
+};
+/** Hydrates an access key entry to a viem Account. Only works for locally-generated keys with a `keyPair`. */
+export declare function hydrateAccessKey(accessKey: AccessKey): TempoAccount.Account;
+/** Hydrates a store account to a viem Account. */
+export declare function hydrate(account: Store, options: {
+    signable: true;
+}): TempoAccount.Account;
+export declare function hydrate(account: Store, options?: hydrate.Options): TempoAccount.Account | JsonRpcAccount;
+export declare namespace hydrate {
+    type Options = {
+        /** Whether to hydrate signing capability. @default false */
+        signable?: boolean | undefined;
+    };
+}
+//# sourceMappingURL=Account.d.ts.map

package/dist/core/Account.d.ts.map

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

package/dist/core/Account.js

@@ -0,0 +1,64 @@
+import { Provider } from 'ox';
+import {} from 'ox/tempo';
+import { Account as TempoAccount } from 'viem/tempo';
+export function find(options) {
+    const { accessKey = true, address, signable = false, store } = options;
+    const { accessKeys, accounts, activeAccount } = store.getState();
+    const activeAddr = accounts[activeAccount]?.address;
+    const root = address
+        ? accounts.find((a) => a.address === address)
+        : accounts.find((a) => a.address === activeAddr);
+    if (!root)
+        throw address
+            ? new Provider.UnauthorizedError({ message: `Account "${address}" not found.` })
+            : new Provider.DisconnectedError({ message: 'No active account.' });
+    // When accessKey is requested, prefer a locally-signable access key for this address.
+    if (accessKey) {
+        const key = accessKeys.find((a) => a.access.toLowerCase() === root.address.toLowerCase() && a.keyPair);
+        if (key) {
+            // Remove expired access keys.
+            if (key.expiry && key.expiry < Date.now() / 1000)
+                store.setState({ accessKeys: accessKeys.filter((a) => a !== key) });
+            else
+                return hydrateAccessKey(key);
+        }
+    }
+    return hydrate(root, { signable });
+}
+/** Hydrates an access key entry to a viem Account. Only works for locally-generated keys with a `keyPair`. */
+export function hydrateAccessKey(accessKey) {
+    if (!accessKey.keyPair)
+        throw new Provider.UnauthorizedError({
+            message: 'External access key cannot be hydrated for signing.',
+        });
+    return TempoAccount.fromWebCryptoP256(accessKey.keyPair, { access: accessKey.access });
+}
+export function hydrate(account, options = {}) {
+    const { signable = false } = options;
+    if (!signable)
+        return { address: account.address, type: 'json-rpc' };
+    if ('sign' in account && typeof account.sign === 'function')
+        return account;
+    if (!account.keyType)
+        throw new Provider.UnauthorizedError({ message: `Account "${account.address}" cannot sign.` });
+    switch (account.keyType) {
+        case 'secp256k1':
+            return TempoAccount.fromSecp256k1(account.privateKey);
+        case 'p256':
+            return TempoAccount.fromP256(account.privateKey);
+        case 'webCrypto':
+            return TempoAccount.fromWebCryptoP256(account.keyPair);
+        case 'webAuthn':
+            return TempoAccount.fromWebAuthnP256(account.credential, {
+                rpId: account.credential.rpId,
+            });
+        case 'webAuthn_headless':
+            return TempoAccount.fromHeadlessWebAuthn(account.privateKey, {
+                rpId: account.rpId,
+                origin: account.origin,
+            });
+        default:
+            throw new Provider.UnauthorizedError({ message: 'Unknown key type.' });
+    }
+}
+//# sourceMappingURL=Account.js.map

package/dist/core/Account.js.map

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