Tempo

https://docs.tempo.xyz
Admin
Tempo is a general-purpose blockchain optimized for payments, designed as a low-cost,...
Tokens:715,289
Snippets:14,605
Trust Score:8.6
Update:5 months ago
Show doc for...
Tokens:
Raw
### Install Tempo CLI and Search Web

Source: https://docs.tempo.xyz/guide/machine-payments/use-cases/web-search-and-research

Install the Tempo CLI and wallet, then use it to perform a web search via the Parallel service. This demonstrates the basic setup and a sample query.

```bash
# Install Tempo CLI + wallet
curl -L https://tempo.xyz/install | bash && tempo add request && tempo wallet login

# Search the web via Parallel
tempo request parallelmpp.dev/search \
  -d '{"query": "machine payments protocol"}'
```

--------------------------------

### Install Tempo Go SDK

Source: https://docs.tempo.xyz/sdk/go

Install the Tempo Go SDK using the go get command. Requires Go 1.21 or higher.

```bash
go get github.com/tempoxyz/tempo-go@v0.3.0
```

--------------------------------

### Install foundryup

Source: https://docs.tempo.xyz/sdk/foundry

Install the Foundryup script to manage Foundry installations. This is the first step to getting Tempo support.

```bash
curl -L https://foundry.paradigm.xyz | bash
```

--------------------------------

### Initialize Foundry Project Template

Source: https://docs.tempo.xyz/sdk/foundry/signature-verifier

Initialize the Tempo project template to get a working example of signature verification.

```bash
forge init --template tempo my-project && cd my-project
```

--------------------------------

### Install and Login to Tempo CLI

Source: https://docs.tempo.xyz/guide/getting-funds

Install the Tempo CLI and log in to your wallet. Ensure you have the necessary permissions before executing.

```bash
curl -fsSL https://tempo.xyz/install | bash
tempo wallet login
```

--------------------------------

### Machine Payments Quickstarts

Source: https://docs.tempo.xyz/guide/node/validator-setup

Guides for setting up machine payments as an agent or client.

```APIDOC
## Agent Quickstart /guide/machine-payments/agent

### Description
Use the tempo CLI to discover services, preview costs, and make paid requests from a terminal or AI agent — no SDK required.

## Client Quickstart /guide/machine-payments/client

### Description
Set up an MPP client on Tempo. Polyfill fetch to automatically pay for 402 responses with TIP-20 stablecoins.
```

--------------------------------

### Install Tempo CLI and Get Stock Data

Source: https://docs.tempo.xyz/guide/machine-payments/use-cases/financial-data

Installs the Tempo CLI and wallet, then makes a request to Alpha Vantage for daily stock data.

```bash
# Install Tempo CLI + wallet
curl -L https://tempo.xyz/install | bash && tempo add request && tempo wallet login

# Get stock data via Alpha Vantage
tempo request alphavantage.mpp.paywithlocus.com/query \
  -d '{"function": "TIME_SERIES_DAILY", "symbol": "AAPL"}'
```

--------------------------------

### Install Tempo CLI and Wallet

Source: https://docs.tempo.xyz/guide/machine-payments/use-cases/image-and-media-generation

Install the Tempo CLI and set up your wallet for making requests. This is a prerequisite for using Tempo services.

```bash
# Install Tempo CLI + wallet
curl -L https://tempo.xyz/install | bash && tempo add request && tempo wallet login
```

--------------------------------

### Install dependencies

Source: https://docs.tempo.xyz/guide/machine-payments/client

Install the mppx and viem packages using your preferred package manager.

```bash
npm install mppx viem
```

```bash
pnpm add mppx viem
```

```bash
bun add mppx viem
```

--------------------------------

### Install the Tempo Python SDK

Source: https://docs.tempo.xyz/sdk/python

Install the SDK using pip. Requires Python 3.9+ and web3.py 7.0+.

```bash
pip install pytempo
```

--------------------------------

### Build Tempo from Source

Source: https://docs.tempo.xyz/guide/node/installation

Installs Rust, sets up the environment, and then builds and installs the Tempo node from its Git repository using Cargo.

```bash
# Install Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source $HOME/.cargo/env

# Build and install from source using cargo
cargo install --git https://github.com/tempoxyz/tempo.git tempo --root /usr/local
tempo --version
```

--------------------------------

### Set up AI Agent with Tempo Skills

Source: https://docs.tempo.xyz/guide/machine-payments/agent

Instruct your AI agent to read the Tempo skill setup guide and configure Tempo's wallet and request skills. This enables the agent to discover services, preview costs, and make paid requests within defined spending limits.

```txt
Read https://tempo.xyz/SKILL.md and set up tempo
```

--------------------------------

### Install Accounts SDK via bun

Source: https://docs.tempo.xyz/accounts

Install the Tempo Accounts SDK using bun. This is another package manager option for installing the SDK.

```bash
bun i accounts
```

--------------------------------

### Install Tempo CLI

Source: https://docs.tempo.xyz/cli

Use this command to install the Tempo CLI. To update later, run `tempoup`.

```bash
curl -fsSL https://tempo.xyz/install | bash
```

--------------------------------

### Agent Quickstart

Source: https://docs.tempo.xyz/guide/machine-payments/use-cases/agent-to-agent

Use the tempo CLI to discover services, preview costs, and make paid requests from a terminal or AI agent — no SDK required.

```APIDOC
## Agent Quickstart

Use the tempo CLI to discover services, preview costs, and make paid requests from a terminal or AI agent — no SDK required.
```

--------------------------------

### Client Quickstart

Source: https://docs.tempo.xyz/guide/machine-payments/streamed-payments

Set up an MPP client on Tempo. Polyfill fetch to automatically pay for 402 responses with TIP-20 stablecoins.

```APIDOC
## Client Quickstart

### Description
Set up an MPP client on Tempo. Polyfill fetch to automatically pay for 402 responses with TIP-20 stablecoins.

### Method
N/A (Client-side setup)

### Endpoint
N/A

### Parameters
N/A

### Request Example
N/A

### Response
N/A
```

--------------------------------

### Install Tempo Docs Skill

Source: https://docs.tempo.xyz/guide/using-tempo-with-ai

Install the Tempo Docs skill using npm to provide AI coding agents with access to Tempo documentation, source code, and examples.

```bash
npx skills add tempoxyz/docs
```

--------------------------------

### Install Tempo CLI and Hire an Agent

Source: https://docs.tempo.xyz/guide/machine-payments/use-cases/agent-to-agent

Installs the Tempo CLI and wallet, then demonstrates hiring an agent for a code review task via Auto.exchange using a Tempo Charge.

```bash
# Install Tempo CLI + wallet
curl -L https://tempo.xyz/install | bash && tempo add request && tempo wallet login

# Hire an agent via Auto.exchange
tempo request api.auto.exchange/v1/tasks \
  -d '{"task": "Review this Python function for bugs", "code": "def add(a, b): return a - b"}'
```

--------------------------------

### Example: Place a Flip Order for Liquidity

Source: https://docs.tempo.xyz/protocol/exchange/providing-liquidity

Example of placing a flip order to start as a bid at $0.9990 and automatically flip to an ask at $1.0010 when filled. This creates a perpetual liquidity position.

```solidity
// Place a bid at $0.9990 that flips to an ask at $1.0010
uint128 orderId = exchange.placeFlip(
    USDG_ADDRESS,
    1000e6,      // Amount: 1000 USDG
    true,        // isBid: start as a buy order
    -10,         // tick: buy at $0.9990
    10           // flipTick: sell at $1.0010 after filled
);
```

--------------------------------

### Start a Reward Distribution with wagmi/tempo Hooks

Source: https://docs.tempo.xyz/guide/issuance/distribute-rewards

Anyone can initiate a reward distribution, allocating tokens to opted-in holders proportionally to their balance. This example uses wagmi/tempo hooks to start a reward distribution.

```tsx
import React from 'react'
import { Hooks } from 'wagmi/tempo'
import { parseUnits } from 'viem'

// @noErrors
export function StartReward() {
  const tokenAddress = '0x...' // Your token address

  const { data: metadata } = Hooks.token.useGetMetadata({
    token: tokenAddress,
  })

  const start = Hooks.reward.useStartSync()

  const handleStart = () => { // [!code hl] 
    if (!metadata) return // [!code hl] 
    start.mutate({ // [!code hl] 
      amount: parseUnits('50', metadata.decimals), // [!code hl] 
      token: tokenAddress, // [!code hl] 
    }) // [!code hl] 
  } // [!code hl] 

  return (
    <button
      disabled={start.isPending || !metadata}
      onClick={handleStart}
      type="button"
    >
      {start.isPending ? 'Starting...' : 'Start Reward'}
    </button>
  )
}
```

```tsx
// @noErrors
import { createConfig, http } from 'wagmi'
import { tempo } from 'viem/chains'
import { tempoWallet } from 'accounts/wagmi'

export const config = createConfig({
  chains: [tempo],
  connectors: [tempoWallet()],
  transports: {
    [tempo.id]: http(),
  },
})
```

--------------------------------

### Viem Client Setup

Source: https://docs.tempo.xyz/guide/payments/pay-fees-in-any-stablecoin

This snippet demonstrates how to set up a Viem client configured for Tempo. It includes necessary imports and client configuration.

```ts
// [!include ~/snippets/viem.config.ts:setup]
```

--------------------------------

### Install Tempo CLI and Translate Text

Source: https://docs.tempo.xyz/guide/machine-payments/use-cases/translation-and-language

Installs the Tempo CLI and wallet, then demonstrates how to translate text using the DeepL service via Tempo.

```bash
# Install Tempo CLI + wallet
curl -L https://tempo.xyz/install | bash && tempo add request && tempo wallet login

# Translate text via DeepL
tempo request deepl.mpp.paywithlocus.com/v2/translate \
  -d '{"text": ["Hello, world!"], "target_lang": "DE"}'
```

--------------------------------

### Create Local Provider

Source: https://docs.tempo.xyz/accounts/api/local

Initializes the `Provider` with the `local` adapter. This example demonstrates the basic setup for using the local adapter.

```typescript
import { local, Provider } from 'accounts'

const provider = Provider.create({
  adapter: local({
    loadAccounts: async () => ({
      accounts: [{ address: '0x...' }],
    }),
  }),
})
```

--------------------------------

### Get Wallet Capabilities

Source: https://docs.tempo.xyz/accounts/rpc/wallet_getCapabilities

Request the capabilities of a connected wallet for a specific address. This example demonstrates a basic request to the wallet_getCapabilities method.

```typescript
const capabilities = await provider.request({
  method: 'wallet_getCapabilities',
  params: ['0x...'],
})
```

--------------------------------

### Get Call Status Example

Source: https://docs.tempo.xyz/accounts/rpc/wallet_getCallsStatus

Use this method to request the status of a batch of calls using the provider's request method. Ensure you provide a valid batch ID.

```typescript
const status = await provider.request({
  method: 'wallet_getCallsStatus',
  params: ['0x...'],
})
```

--------------------------------

### Install Tempo CLI and Call OpenAI

Source: https://docs.tempo.xyz/guide/machine-payments/use-cases/ai-model-access

Install the Tempo CLI and wallet, then use it to call OpenAI's GPT-4o model for chat completions without needing an API key. This demonstrates the pay-per-request functionality.

```bash
# Install Tempo CLI + wallet
curl -L https://tempo.xyz/install | bash && tempo add request && tempo wallet login

# Call OpenAI with pay-per-request — no API key needed
tempo request openai.mpp.tempo.xyz/v1/chat/completions \
  -d '{"model": "gpt-4o", "messages": [{"role": "user", "content": "Hello"}]}'
```

--------------------------------

### TypeScript: Bridge Assets with Relay (viem)

Source: https://docs.tempo.xyz/guide/bridge-relay

Use viem to interact with the Relay API for cross-chain asset transfers. This example demonstrates getting a quote, executing the transaction steps, and polling for completion.

```typescript
import { createWalletClient, createPublicClient, http } from 'viem'
import { tempo } from 'viem/chains'
import { privateKeyToAccount } from 'viem/accounts'

const account = privateKeyToAccount('0x...')

const walletClient = createWalletClient({
  account,
  chain: tempo,
  transport: http(),
})

const publicClient = createPublicClient({
  chain: tempo,
  transport: http(),
})

// 1. Get a quote from Relay (Tempo -> Base)
const quoteRes = await fetch('https://api.relay.link/quote/v2', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    user: account.address,
    originChainId: 4217, // Tempo
    destinationChainId: 8453, // Base
    originCurrency: '0x20C000000000000000000000b9537d11c60E8b50', // USDC.e on Tempo
    destinationCurrency: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', // USDC on Base
    amount: '1000000', // 1 USDC.e (6 decimals)
    tradeType: 'EXACT_INPUT',
  }),
})

const quote = await quoteRes.json()

// 2. Execute each step
for (const step of quote.steps) {
  for (const item of step.items) {
    if (step.kind === 'transaction') {
      const hash = await walletClient.sendTransaction({
        to: item.data.to,
        data: item.data.data,
        value: BigInt(item.data.value || '0'),
      })

      await publicClient.waitForTransactionReceipt({ hash })
    }
  }
}

// 3. Poll for completion
const requestId = quote.steps[0].requestId

const pollStatus = async () => {
  while (true) {
    const statusRes = await fetch(
      `https://api.relay.link/intents/status/v3?requestId=${requestId}`
    )
    const status = await statusRes.json()

    if (status.status === 'success') {
      console.log('Bridge complete:', status.txHashes)
      return status
    }
    if (status.status === 'failure') {
      throw new Error('Bridge failed')
    }

    await new Promise((r) => setTimeout(r, 1000))
  }
}

await pollStatus()

```

--------------------------------

### Install Tempo using Pre-built Binary

Source: https://docs.tempo.xyz/guide/node/installation

Installs the latest Tempo binary using curl and bash. To update Tempo in the future, run `tempoup`.

```bash
curl -L https://tempo.xyz/install | bash
tempo --version
```

--------------------------------

### Tempo CLI: tempo wallet balance example

Source: https://docs.tempo.xyz/protocol/tips/tip-1020

Shows how to check the balance of an account using the `tempo wallet balance` command. Ensure your Tempo wallet is configured and accessible.

```bash
tempo wallet balance --address tempo1abcdefg...
```

--------------------------------

### Install Accounts SDK via pnpm

Source: https://docs.tempo.xyz/accounts

Install the Tempo Accounts SDK using pnpm. This is an alternative package manager for installing the SDK.

```bash
pnpm i accounts
```
Tokens:
Raw