accounts 0.4.25 → 0.5.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # accounts
 
+## 0.5.0
+
+### Minor Changes
+
+- 5b4ce03: Public release.
+
 ## 0.4.25
 
 ### Patch Changes

package/README.md

@@ -1,103 +1,68 @@
-# Tempo Accounts SDK
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset=".github/logo-dark.svg">
+    <source media="(prefers-color-scheme: light)" srcset=".github/logo-light.svg">
+    <img alt="accounts" src=".github/logo-light.svg" width="auto" height="100">
+  </picture>
+</p>
 
-Accounts SDK for Tempo Wallets & Apps.
+<p align="center"><b>Accounts SDK for Apps and Wallets building on Tempo.</b></p>
 
-## Install
-
-```sh
-pnpm i accounts
-```
+<p align="center">
+  <a href="#quick-prompt">Quick Prompt</a> · <a href="#install">Install</a> · <a href="#documentation">Documentation</a> · <a href="#examples">Examples</a> · <a href="#development">Development</a> · <a href="#license">License</a>
+</p>
 
-## Usage
+---
 
-### Vanilla JS
+## Quick Prompt
 
-You can get set up with the Accounts SDK with pure JavaScript by using the
-`Provider` instance.
+Prompt your agent:
 
-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.
-
-```tsx
-import { Provider } from 'accounts'
-
-const provider = Provider.create()
-
-const { accounts } = await provider.request({
-  method: 'wallet_connect',
-})
+```
+Read docs.tempo.xyz/accounts and integrate Tempo Wallet into my application
 ```
 
-### Viem
-
-The Provider provides a Viem Client instance via the `getClient` accessor.
+## Install
 
-```tsx
-import { Provider } from 'accounts'
+```bash
+npm i accounts
+```
 
-const provider = Provider.create()
+```bash
+pnpm i accounts
+```
 
-const client = provider.getClient()
+```bash
+bun i accounts
 ```
 
-### Wagmi
+## Documentation
 
-Use the `tempoWallet` Wagmi connector to allow your Wagmi application to enable the Tempo Wallet dialog.
+For documentation and guides, visit [docs.tempo.xyz/accounts](https://docs.tempo.xyz/accounts).
 
-```tsx
-import { createConfig, http } from 'wagmi'
-import { tempo } from 'wagmi/chains'
-import { tempoWallet } from 'accounts/wagmi'
+## Getting Help
 
-export const wagmiConfig = createConfig({
-  chains: [tempo],
-  connectors: [tempoWallet()],
-  transports: {
-    [tempo.id]: http(),
-  },
-})
-```
+Have questions or building something cool with the Accounts SDK?
 
-### CLI
-
-Use the `accounts/cli` entrypoint when an external CLI already owns the local key material and only needs the Tempo Wallet browser flow to authenticate the user and authorize that key.
-
-```ts
-import { Provider } from 'accounts/cli'
-
-const provider = Provider.create({
-  host: 'https://wallet.example.com/cli-auth',
-})
-
-const { accounts } = await provider.request({
-  method: 'wallet_connect',
-  params: [
-    {
-      capabilities: {
-        authorizeAccessKey: {
-          expiry: Math.floor(Date.now() / 1000) + 3600,
-          publicKey: '0x...',
-        },
-      },
-    },
-  ],
-})
-```
+Join the Telegram group to chat with the team and other devs: [@mpp_devs](https://t.me/mpp_devs)
 
-## Adapters
+## Examples
 
-| 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.   |
-| `cli`                    | Device-code based adapter for CLI authentication and access key authorization.     |
-| `local`                  | Key agnostic adapter to define arbitrary account/key types and signing mechanisms. |
+| Example                                                                 | Description                                                                       |
+| ----------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
+| [basic](./examples/basic)                                               | Wagmi-based setup using the `tempoWallet` connector to connect to Tempo Wallets.  |
+| [cli](./examples/cli)                                                   | Minimal CLI setup to connect and authorize local keys using Tempo Wallets.        |
+| [domain-bound-webauthn](./examples/domain-bound-webauthn)               | Domain-bound passkey example using Wagmi and the `webAuthn` connector.            |
+| [with-access-key](./examples/with-access-key)                           | Authorize access keys using Tempo Wallets to submit transactions without prompts. |
+| [with-access-key-and-webauthn](./examples/with-access-key-and-webauthn) | Authorize access keys using domain-bound Passkeys.                                |
+| [with-fee-payer](./examples/with-fee-payer)                             | Sponsor transactions via Tempo Wallets.                                           |
+| [with-fee-payer-and-webauthn](./examples/with-fee-payer-and-webauthn)   | Sponsor transactions using a Cloudflare Worker with domain-bound Passkeys.        |
 
 ## Development
 
 ```sh
 pnpm dev              # start dialog + dialog-ref + web playground dev servers
-pnpm playground:cli   # run the CLI playground client
+pnpm dev:cli          # start the CLI playground client
 pnpm dev:dialog       # start Tempo Wallet dialog only
 pnpm dev:dialog-ref   # start reference dialog implementation only (port 5174)
 pnpm dev:playground   # start web playground only
@@ -114,6 +79,14 @@ pnpm test             # run tests
 > - `https://playground.a:5173`
 > - `https://playground.b:5175`
 
+### Playgrounds
+
+| Playground                   | Command          | Description                                  |
+| ---------------------------- | ---------------- | -------------------------------------------- |
+| [web](./playgrounds/web)     | `pnpm dev`       | Web playground for dialog + adapter testing. |
+| [wagmi](./playgrounds/wagmi) | `pnpm dev:wagmi` | Wagmi-based playground with connectors.      |
+| [cli](./playgrounds/cli)     | `pnpm dev:cli`   | CLI playground for device-code auth flow.    |
+
 ### Reference Implementations
 
 The `ref-impls/` directory contains reference implementations for building on the Account SDK:
@@ -125,4 +98,15 @@ The `ref-impls/` directory contains reference implementations for building on th
 
 ## License
 
-MIT
+<sup>
+Licensed under either of <a href="LICENSE-APACHE">Apache License, Version
+2.0</a> or <a href="LICENSE-MIT">MIT license</a> at your option.
+</sup>
+
+<br>
+
+<sub>
+Unless you explicitly state otherwise, any contribution intentionally submitted
+for inclusion in these packages by you, as defined in the Apache-2.0 license,
+shall be dual licensed as above, without any additional terms or conditions.
+</sub>

package/package.json

@@ -2,7 +2,7 @@
   "name": "accounts",
   "description": "Tempo Accounts SDK",
   "type": "module",
-  "version": "0.4.25",
+  "version": "0.5.0",
   "dependencies": {
     "@remix-run/fetch-router": "~0.17.0",
     "idb-keyval": "^6.2.2",
@@ -33,7 +33,7 @@
   "repository": {
     "url": "https://github.com/tempoxyz/accounts"
   },
-  "license": "MIT",
+  "license": "MIT OR Apache-2.0",
   "files": [
     "dist",
     "src",

package/LICENSE

@@ -1,21 +0,0 @@
-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.