https://github.com/tempoxyz/tempo
the blockchain for payments
https://github.com/tempoxyz/tempo
Last synced: about 1 month ago
JSON representation
the blockchain for payments
- Host: GitHub
- URL: https://github.com/tempoxyz/tempo
- Owner: tempoxyz
- License: apache-2.0
- Created: 2025-06-02T19:55:49.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2026-04-10T08:46:03.000Z (about 1 month ago)
- Last Synced: 2026-04-10T09:13:29.266Z (about 1 month ago)
- Language: Rust
- Homepage: https://docs.tempo.xyz
- Size: 56.7 MB
- Stars: 916
- Watchers: 10
- Forks: 270
- Open Issues: 123
-
Metadata Files:
- Readme: README.md
- License: LICENSE-APACHE
- Codeowners: .github/CODEOWNERS
- Agents: AGENTS.md
Awesome Lists containing this project
- awesome-rust - tempoxyz/tempo - A blockchain built for stablecoin payments at scale, with EVM compatibility, sub-second finality, and native smart account features, built on the Reth SDK (Applications / Blockchain)
- awesome-rust-with-stars - tempoxyz/tempo - second finality, and native smart account features, built on the Reth SDK | 2026-03-21 | (Applications / Blockchain)
- fucking-awesome-rust - tempoxyz/tempo - A blockchain built for stablecoin payments at scale, with EVM compatibility, sub-second finality, and native smart account features, built on the Reth SDK (Applications / Blockchain)
README
# Tempo
The blockchain for payments at scale.
[Tempo](https://docs.tempo.xyz/) is a blockchain designed specifically for stablecoin payments. Its architecture focuses on high throughput, low cost, and features that financial institutions, payment service providers, and fintech platforms expect from modern payment infrastructure.
You can get started today by integrating with the [Tempo testnet](https://docs.tempo.xyz/quickstart/integrate-tempo), [building on Tempo](https://docs.tempo.xyz/guide/use-accounts), [running a Tempo node](https://docs.tempo.xyz/guide/node), reading the [Tempo protocol specs](https://docs.tempo.xyz/protocol) or by [building with Tempo SDKs](https://docs.tempo.xyz/sdk).
## What makes Tempo different
- [TIP‑20 token standard](https://docs.tempo.xyz/protocol/tip20/overview) (enshrined ERC‑20 extensions)
- Predictable payment throughput via dedicated payment lanes reserved for TIP‑20 transfers (eliminates noisy‑neighbor contention).
- Native reconciliation with on‑transfer memos and commitment patterns (hash/locator) for off‑chain PII and large data.
- Built‑in compliance through [TIP‑403 Policy Registry](https://docs.tempo.xyz/protocol/tip403/overview): single policy shared across multiple tokens, updated once and enforced everywhere.
- Low, predictable fees in [stablecoins](https://docs.tempo.xyz/learn/stablecoins)
- Users pay gas directly in USD-stablecoins at launch; the [Fee AMM](https://docs.tempo.xyz/protocol/fees/fee-amm#fee-amm-overview) automatically converts to the validator’s preferred stablecoin.
- TIP‑20 transfers target sub‑millidollar costs (<$0.001).
- [Tempo Transactions](https://docs.tempo.xyz/guide/tempo-transaction) (native “smart accounts”)
- Batched payments: atomic multi‑operation payouts (payroll, settlements, refunds).
- Fee sponsorship: apps can pay users' gas to streamline onboarding and flows.
- Scheduled payments: protocol‑level time windows for recurring and timed disbursements.
- Modern authentication: passkeys via WebAuthn/P256 (biometric sign‑in, secure enclave, cross‑device sync).
- Performance and finality
- Built on the [Reth SDK](https://github.com/paradigmxyz/reth), the most performant and flexible EVM (Ethereum Virtual Machine) execution client.
- Simplex Consensus (via [Commonware](https://commonware.xyz/)): fast, sub‑second finality in normal conditions; graceful degradation under adverse networks.
- Coming soon
- On‑chain FX and non‑USD stablecoin support for direct on‑chain liquidity; pay fees in more currencies.
- Native private token standard: opt‑in privacy for balances/transfers coexisting with issuer compliance and auditability.
## What makes Tempo familiar
- Fully compatible with the Ethereum Virtual Machine (EVM), targeting the Osaka hardfork.
- Deploy and interact with smart contracts using the same tools, languages, and frameworks used on Ethereum, such as Solidity, Foundry, and Hardhat.
- All Ethereum JSON-RPC methods work out of the box.
While the execution environment mirrors Ethereum's, Tempo introduces some differences optimized for payments, described [here](https://docs.tempo.xyz/quickstart/evm-compatibility).
## Getting Started
### As a user
You can connect to Tempo's public testnet using the following details:
| Property | Value |
| ------------------ | ---------------------------------- |
| **Network Name** | Tempo Testnet (Moderato) |
| **Currency** | `USD` |
| **Chain ID** | `42431` |
| **HTTP URL** | `https://rpc.moderato.tempo.xyz` |
| **WebSocket URL** | `wss://rpc.moderato.tempo.xyz` |
| **Block Explorer** | `https://explore.tempo.xyz` |
Next, grab some stablecoins to test with from Tempo's [Faucet](https://docs.tempo.xyz/quickstart/faucet#faucet).
Alternatively, use [`cast`](https://github.com/tempoxyz/tempo-foundry):
```bash
cast rpc tempo_fundAddress
--rpc-url https://rpc.moderato.tempo.xyz
```
### As an operator
We provide three different installation paths: installing a pre-built binary, building from source or using our provided Docker image.
- [Pre-built Binary](https://docs.tempo.xyz/guide/node/installation#pre-built-binary)
- [Build from Source](https://docs.tempo.xyz/guide/node/installation#build-from-source)
- [Docker](https://docs.tempo.xyz/guide/node/installation#docker)
See the [Tempo documentation](https://docs.tempo.xyz/guide/node) for instructions on how to install and run Tempo.
### As a developer
Tempo has several SDKs to help you get started building on Tempo:
- [TypeScript](https://docs.tempo.xyz/sdk/typescript)
- [Rust](https://docs.tempo.xyz/sdk/rust)
- [Go](https://docs.tempo.xyz/sdk/go)
- [Foundry](https://docs.tempo.xyz/sdk/foundry)
Want to contribute?
First, clone the repository:
```
git clone https://github.com/tempoxyz/tempo
cd tempo
```
Next, install [`just`](https://github.com/casey/just?tab=readme-ov-file#packages).
Install the dependencies:
```bash
just
```
Build Tempo:
```bash
just build-all
```
Run the tests:
```bash
cargo nextest run
```
Start a `localnet`:
```bash
just localnet
```
## Contributing
Our contributor guidelines can be found in [`CONTRIBUTING.md`](https://github.com/tempoxyz/tempo?tab=contributing-ov-file).
## Security
See [`SECURITY.md`](https://github.com/tempoxyz/tempo?tab=security-ov-file). Note: Tempo is still undergoing audit and does not have an active bug bounty. Submissions will not be eligible for a bounty until audits have concluded.
## License
Licensed under either of [Apache License](./LICENSE-APACHE), Version
2.0 or [MIT License](./LICENSE-MIT) at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in these crates by you, as defined in the Apache-2.0 license,
shall be dual licensed as above, without any additional terms or conditions.