+ 
+
+
+
+
+
Press Enter or click to start
+
+
+### With the CLI
+
+Fund your wallet from the terminal using the [Tempo CLI](/cli):
+
+```bash
+tempo wallet fund
+```
+
+### With an agent
+
+Paste this into your agent to set up Tempo Wallet and add funds:
+
+```
+Read https://wallet.tempo.xyz/SKILL.md and fund my Tempo Wallet
+```
+
+## Testnet Funds
+
+For development and testing, use the [Tempo Faucet](/quickstart/faucet).
+
+The faucet provides `pathUSD`, `alphaUSD`, `betaUSD`, and `thetaUSD` test stablecoins.
diff --git a/src/pages/guide/issuance/create-a-stablecoin.mdx b/src/pages/guide/issuance/create-a-stablecoin.mdx
index 4599ca55..cfe25a5c 100644
--- a/src/pages/guide/issuance/create-a-stablecoin.mdx
+++ b/src/pages/guide/issuance/create-a-stablecoin.mdx
@@ -68,11 +68,11 @@ export function AddFunds() {
```tsx twoslash [config.ts] filename="config.ts"
// @noErrors
import { createConfig, http } from 'wagmi'
-import { tempoModerato } from 'viem/chains'
+import { tempo } from 'viem/chains'
import { KeyManager, webAuthn } from 'wagmi/tempo'
export const config = createConfig({
- chains: [tempoModerato],
+ chains: [tempo],
connectors: [webAuthn({
keyManager: KeyManager.localStorage(),
})],
@@ -129,11 +129,11 @@ export function CreateStablecoin() {
```tsx twoslash [config.ts] filename="config.ts"
// @noErrors
import { createConfig, http } from 'wagmi'
-import { tempoModerato } from 'viem/chains'
+import { tempo } from 'viem/chains'
import { KeyManager, webAuthn } from 'wagmi/tempo'
export const config = createConfig({
- chains: [tempoModerato],
+ chains: [tempo],
connectors: [webAuthn({
keyManager: KeyManager.localStorage(),
})],
@@ -197,11 +197,11 @@ export function CreateStablecoin() {
```tsx twoslash [config.ts] filename="config.ts"
// @noErrors
import { createConfig, http } from 'wagmi'
-import { tempoModerato } from 'viem/chains'
+import { tempo } from 'viem/chains'
import { KeyManager, webAuthn } from 'wagmi/tempo'
export const config = createConfig({
- chains: [tempoModerato],
+ chains: [tempo],
connectors: [webAuthn({
keyManager: KeyManager.localStorage(),
})],
@@ -265,11 +265,11 @@ export function CreateStablecoin() {
```tsx twoslash [config.ts] filename="config.ts"
// @noErrors
import { createConfig, http } from 'wagmi'
-import { tempoModerato } from 'viem/chains'
+import { tempo } from 'viem/chains'
import { KeyManager, webAuthn } from 'wagmi/tempo'
export const config = createConfig({
- chains: [tempoModerato],
+ chains: [tempo],
connectors: [webAuthn({
keyManager: KeyManager.localStorage(),
})],
diff --git a/src/pages/guide/issuance/distribute-rewards.mdx b/src/pages/guide/issuance/distribute-rewards.mdx
index 0e5bab24..dd9c43af 100644
--- a/src/pages/guide/issuance/distribute-rewards.mdx
+++ b/src/pages/guide/issuance/distribute-rewards.mdx
@@ -76,11 +76,11 @@ export function OptInToRewards() {
```tsx twoslash [config.ts] filename="config.ts"
// @noErrors
import { createConfig, http } from 'wagmi'
-import { tempoModerato } from 'viem/chains'
+import { tempo } from 'viem/chains'
import { KeyManager, webAuthn } from 'wagmi/tempo'
export const config = createConfig({
- chains: [tempoModerato],
+ chains: [tempo],
connectors: [webAuthn({
keyManager: KeyManager.localStorage(),
})],
@@ -136,11 +136,11 @@ export function StartReward() {
```tsx twoslash [config.ts] filename="config.ts"
// @noErrors
import { createConfig, http } from 'wagmi'
-import { tempoModerato } from 'viem/chains'
+import { tempo } from 'viem/chains'
import { KeyManager, webAuthn } from 'wagmi/tempo'
export const config = createConfig({
- chains: [tempoModerato],
+ chains: [tempo],
connectors: [webAuthn({
keyManager: KeyManager.localStorage(),
})],
@@ -189,11 +189,11 @@ export function ClaimReward() {
```tsx twoslash [config.ts] filename="config.ts"
// @noErrors
import { createConfig, http } from 'wagmi'
-import { tempoModerato } from 'viem/chains'
+import { tempo } from 'viem/chains'
import { KeyManager, webAuthn } from 'wagmi/tempo'
export const config = createConfig({
- chains: [tempoModerato],
+ chains: [tempo],
connectors: [webAuthn({
keyManager: KeyManager.localStorage(),
})],
diff --git a/src/pages/guide/issuance/manage-stablecoin.mdx b/src/pages/guide/issuance/manage-stablecoin.mdx
index fdb4560b..4cd91cb0 100644
--- a/src/pages/guide/issuance/manage-stablecoin.mdx
+++ b/src/pages/guide/issuance/manage-stablecoin.mdx
@@ -73,11 +73,11 @@ export function GrantRoles() {
```tsx twoslash [config.ts] filename="config.ts"
// @noErrors
import { createConfig, http } from 'wagmi'
-import { tempoModerato } from 'viem/chains'
+import { tempo } from 'viem/chains'
import { KeyManager, webAuthn } from 'wagmi/tempo'
export const config = createConfig({
- chains: [tempoModerato],
+ chains: [tempo],
connectors: [webAuthn({
keyManager: KeyManager.localStorage(),
})],
@@ -152,11 +152,11 @@ export function GrantRoles() {
```tsx twoslash [config.ts] filename="config.ts"
// @noErrors
import { createConfig, http } from 'wagmi'
-import { tempoModerato } from 'viem/chains'
+import { tempo } from 'viem/chains'
import { KeyManager, webAuthn } from 'wagmi/tempo'
export const config = createConfig({
- chains: [tempoModerato],
+ chains: [tempo],
connectors: [webAuthn({
keyManager: KeyManager.localStorage(),
})],
@@ -265,11 +265,11 @@ export function RevokeRoles() {
```tsx twoslash [config.ts] filename="config.ts"
// @noErrors
import { createConfig, http } from 'wagmi'
-import { tempoModerato } from 'viem/chains'
+import { tempo } from 'viem/chains'
import { KeyManager, webAuthn } from 'wagmi/tempo'
export const config = createConfig({
- chains: [tempoModerato],
+ chains: [tempo],
connectors: [webAuthn({
keyManager: KeyManager.localStorage(),
})],
@@ -336,11 +336,11 @@ export function SetSupplyCap() {
```tsx twoslash [config.ts] filename="config.ts"
// @noErrors
import { createConfig, http } from 'wagmi'
-import { tempoModerato } from 'viem/chains'
+import { tempo } from 'viem/chains'
import { KeyManager, webAuthn } from 'wagmi/tempo'
export const config = createConfig({
- chains: [tempoModerato],
+ chains: [tempo],
connectors: [webAuthn({
keyManager: KeyManager.localStorage(),
})],
@@ -445,11 +445,11 @@ export function LinkTokenPolicy() {
```tsx twoslash [config.ts] filename="config.ts"
// @noErrors
import { createConfig, http } from 'wagmi'
-import { tempoModerato } from 'viem/chains'
+import { tempo } from 'viem/chains'
import { KeyManager, webAuthn } from 'wagmi/tempo'
export const config = createConfig({
- chains: [tempoModerato],
+ chains: [tempo],
connectors: [webAuthn({
keyManager: KeyManager.localStorage(),
})],
@@ -525,11 +525,11 @@ export function PauseUnpauseTransfers() {
```tsx twoslash [config.ts] filename="config.ts"
// @noErrors
import { createConfig, http } from 'wagmi'
-import { tempoModerato } from 'viem/chains'
+import { tempo } from 'viem/chains'
import { KeyManager, webAuthn } from 'wagmi/tempo'
export const config = createConfig({
- chains: [tempoModerato],
+ chains: [tempo],
connectors: [webAuthn({
keyManager: KeyManager.localStorage(),
})],
@@ -599,11 +599,11 @@ export function BurnBlocked() {
```tsx twoslash [config.ts] filename="config.ts"
// @noErrors
import { createConfig, http } from 'wagmi'
-import { tempoModerato } from 'viem/chains'
+import { tempo } from 'viem/chains'
import { KeyManager, webAuthn } from 'wagmi/tempo'
export const config = createConfig({
- chains: [tempoModerato],
+ chains: [tempo],
connectors: [webAuthn({
keyManager: KeyManager.localStorage(),
})],
diff --git a/src/pages/guide/issuance/mint-stablecoins.mdx b/src/pages/guide/issuance/mint-stablecoins.mdx
index 70621a4b..b4b8caca 100644
--- a/src/pages/guide/issuance/mint-stablecoins.mdx
+++ b/src/pages/guide/issuance/mint-stablecoins.mdx
@@ -76,11 +76,11 @@ export function GrantIssuerRole() {
```tsx twoslash [config.ts] filename="config.ts"
// @noErrors
import { createConfig, http } from 'wagmi'
-import { tempoModerato } from 'viem/chains'
+import { tempo } from 'viem/chains'
import { KeyManager, webAuthn } from 'wagmi/tempo'
export const config = createConfig({
- chains: [tempoModerato],
+ chains: [tempo],
connectors: [webAuthn({
keyManager: KeyManager.localStorage(),
})],
@@ -179,11 +179,11 @@ export function MintToken() {
```tsx twoslash [config.ts] filename="config.ts"
// @noErrors
import { createConfig, http } from 'wagmi'
-import { tempoModerato } from 'viem/chains'
+import { tempo } from 'viem/chains'
import { KeyManager, webAuthn } from 'wagmi/tempo'
export const config = createConfig({
- chains: [tempoModerato],
+ chains: [tempo],
connectors: [webAuthn({
keyManager: KeyManager.localStorage(),
})],
@@ -338,11 +338,11 @@ export function BurnToken() {
```tsx twoslash [config.ts] filename="config.ts"
// @noErrors
import { createConfig, http } from 'wagmi'
-import { tempoModerato } from 'viem/chains'
+import { tempo } from 'viem/chains'
import { KeyManager, webAuthn } from 'wagmi/tempo'
export const config = createConfig({
- chains: [tempoModerato],
+ chains: [tempo],
connectors: [webAuthn({
keyManager: KeyManager.localStorage(),
})],
diff --git a/src/pages/guide/issuance/use-for-fees.mdx b/src/pages/guide/issuance/use-for-fees.mdx
index 0c5cdc36..4ad675c4 100644
--- a/src/pages/guide/issuance/use-for-fees.mdx
+++ b/src/pages/guide/issuance/use-for-fees.mdx
@@ -200,11 +200,11 @@ export function PayWithIssuedToken() {
```tsx twoslash [config.ts] filename="config.ts"
// @noErrors
import { createConfig, http } from 'wagmi'
-import { tempoModerato } from 'viem/chains'
+import { tempo } from 'viem/chains'
import { KeyManager, webAuthn } from 'wagmi/tempo'
export const config = createConfig({
- chains: [tempoModerato],
+ chains: [tempo],
connectors: [webAuthn({
keyManager: KeyManager.localStorage(),
})],
diff --git a/src/pages/guide/machine-payments/client.mdx b/src/pages/guide/machine-payments/client.mdx
new file mode 100644
index 00000000..4ae816d8
--- /dev/null
+++ b/src/pages/guide/machine-payments/client.mdx
@@ -0,0 +1,202 @@
+---
+title: Client Quickstart
+description: Set up an MPP client on Tempo. Polyfill fetch to automatically pay for 402 responses with TIP-20 stablecoins.
+---
+
+import { Card, Cards } from 'vocs'
+
+# Client quickstart
+
+Polyfill `fetch` to handle `402` responses. Your existing code works unchanged — payments happen in the background.
+
+::::steps
+
+### Install dependencies
+
+:::code-group
+```bash [npm]
+npm install mppx viem
+```
+```bash [pnpm]
+pnpm add mppx viem
+```
+```bash [bun]
+bun add mppx viem
+```
+:::
+
+### Define an account
+
+```ts
+import { privateKeyToAccount } from 'viem/accounts'
+
+const account = privateKeyToAccount('0xabc…123')
+```
+
+:::tip
+With Tempo, you can also use [Passkey or WebCrypto accounts](https://viem.sh/tempo/accounts).
+:::
+
+### Create payment handler
+
+Call `Mppx.create` at startup. This polyfills `fetch` to automatically handle `402` payment challenges.
+
+```ts
+import { privateKeyToAccount } from 'viem/accounts'
+import { Mppx, tempo } from 'mppx/client'
+
+const account = privateKeyToAccount('0xabc…123')
+
+Mppx.create({
+ methods: [tempo({ account })],
+})
+```
+
+:::tip
+If you want to avoid polyfilling, use the bound `fetch` instead.
+
+```ts
+const mppx = Mppx.create({
+ polyfill: false,
+ methods: [tempo({ account })]
+})
+
+const response = await mppx.fetch('https://api.example.com/resource')
+```
+:::
+
+### Request protected resources
+
+Use `fetch`. Payment happens when a server returns `402`.
+
+```ts
+const response = await fetch('https://api.example.com/resource')
+```
+
+::::
+
+## Learn more
+
+### Wagmi
+
+You can inject a [Wagmi](https://wagmi.sh) connector into Mppx by passing the `getConnectorClient` function.
+
+:::code-group
+
+```ts [example.ts]
+import { Mppx, tempo } from 'mppx/client'
+import { getConnectorClient } from 'wagmi/actions'
+import { config } from './config'
+
+Mppx.create({
+ methods: [tempo({
+ getClient: (parameters) => getConnectorClient(config, parameters),
+ })],
+})
+```
+
+```ts [config.ts]
+import { createConfig, http } from 'wagmi'
+import { webAuthn } from 'wagmi/tempo'
+import { tempoModerato } from 'viem/chains'
+
+export const config = createConfig({
+ connectors: [webAuthn()],
+ chains: [tempoModerato],
+ transports: {
+ [tempoModerato.id]: http(),
+ },
+})
+```
+
+:::
+
+### Per-request accounts
+
+Pass accounts on individual requests instead of at setup:
+
+```ts
+import { privateKeyToAccount } from 'viem/accounts'
+import { Mppx, tempo } from 'mppx/client'
+
+const mppx = Mppx.create({
+ polyfill: false,
+ methods: [tempo()]
+})
+
+const response = await mppx.fetch('https://api.example.com/resource', {
+ context: {
+ account: privateKeyToAccount('0xabc…123'),
+ }
+})
+```
+
+### Manual payment handling
+
+Use `Mppx.create` for full control over the payment flow:
+
+- Present payment UI before paying
+- Implement custom retry logic
+- Handle credentials manually
+
+```ts
+import { Mppx, tempo } from 'mppx/client'
+import { privateKeyToAccount } from 'viem/accounts'
+
+const mppx = Mppx.create({
+ polyfill: false,
+ methods: [tempo()],
+})
+
+const response = await fetch('https://api.example.com/resource')
+
+if (response.status === 402) {
+ const credential = await mppx.createCredential(response, {
+ account: privateKeyToAccount('0x...'),
+ })
+
+ const paidResponse = await fetch('https://api.example.com/resource', {
+ headers: { Authorization: credential },
+ })
+}
+```
+
+### Payment receipts
+
+On success, the server returns a `Payment-Receipt` header:
+
+```ts
+import { Receipt } from 'mppx'
+
+const response = await fetch('https://api.example.com/resource')
+
+const receipt = Receipt.fromResponse(response)
+
+console.log(receipt.status)
+// success
+console.log(receipt.reference)
+// 0xtx789abc...
+```
+
+## Next steps
+
+