---
updatedAt: 2026-08-07T01:38:11.000Z
agentTools:
  projectIndex: https://docs.onechain.nexus/llms.txt
---

# ONEUSD Bridge

Bridge tokens between BSC, ONE Chain, and Klaytn with one sentence. Native / EIP-2612 permit / approve+bridge auto-dispatch.

<br />

<Callout icon="✨" theme="default">
  **Bridge tokens across chains with one sentence.**

  Drives the [ONEUSD swap-bridge](https://www.crossdefi.io/swap-bridge) backend. Lists pairs, resolves tokens, quotes with fees + native-gas breakdown, polls status, and executes the bridge with the right path automatically.
</Callout>

***

## 1. Install

The block below is a **natural-language prompt to paste into your AI agent** — not a terminal command.

```text Paste-into-agent prompt
Clone https://github.com/to-nexus/skill-cross-crossd into a temporary directory and run the install.sh script inside it to install the cross-crossd skill into my environment. Tell me the result in one line when you're done.
```

<Callout icon="🚧" theme="warn">
  ### **Bash execution required.**

  `bridge` signs transactions; `quote` / `pairs` / `status` are pure read.
</Callout>

### Install all ONE skills at once

```text Paste-into-agent prompt
Clone https://github.com/to-nexus/cross-skills-suite into a temporary directory and run the bootstrap.sh script inside it to install every ONE skill into my environment. Tell me which skills succeeded and which failed.
```

***

## 2. Where it runs

### ✅ Supported · CLI agents with Bash access

Claude Code (CLI) · OpenClaw · Cursor Composer · Codex CLI · Aider · Goose · Gemini CLI · OpenInterpreter · any other Bash-capable CLI.

### ❌ Not supported · Browser / hosted only

Claude.ai (web) · ChatGPT (web) · Gemini (web) · Copilot Chat (web). The bridge tx signing needs `viem` in a local Node runtime.

***

## 3. What you can do

### Read · no auth

| Subcommand  | What it does                                     |
| ----------- | ------------------------------------------------ |
| 🟢 `pairs`  | List supported bridge pairs.                     |
| 🟢 `tokens` | Resolve token metadata for a chain.              |
| 🟢 `quote`  | Quote with full fee + native-gas breakdown.      |
| 🟢 `status` | Poll a bridge progress by `permitId` or tx hash. |

### Auth & write

| Subcommand   | What it does                                                                                                                                      |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| 🟡 `history` | Your bridge history (auth required).                                                                                                              |
| 🔴 `bridge`  | Execute the bridge. Auto-dispatches the right path: **native** (msg.value), **permit** (EIP-2612, no source gas), or **approve+bridge** (ERC-20). |

***

## 4. Try it

```text 🇰🇷 Korean
brídge pairs 보여줘
BSC chain 의 토큰 메타데이터
USDT BSC → ONE 1.0 견적 (수수료/도착시간 포함)
내 브릿지 진행상황 0xabc...
permit-hash 12345 상태
USDT 1개 BSC → ONE 로 브릿지 (확정)
1 native CROSS 를 BSC 로 보내
```

```text 🇺🇸 English
List bridge pairs
Show BSC token metadata
Quote 1 USDT BSC to ONE with fees and ETA
Check status of bridge tx 0xabc...
Permit-hash 12345 status
Bridge 1 USDT from BSC to ONE — confirmed
Send 1 native CROSS to BSC
```

***

## 5. Command reference

| command   | args                                                                                | auth | mutation       | description                    |
| --------- | ----------------------------------------------------------------------------------- | ---- | -------------- | ------------------------------ |
| `pairs`   | —                                                                                   | —    | read           | Supported pairs.               |
| `tokens`  | `--chain <id>`                                                                      | —    | read           | Token metadata.                |
| `quote`   | `<FROM-chainId-tokenAddr> <TO-chainId-tokenAddr> <amount>`                          | —    | read           | Quote + ETA + swap-pool route. |
| `status`  | `<permitId>` or `--tx <hash>`                                                       | —    | read           | Bridge progress.               |
| `history` | —                                                                                   | PK   | read           | Your bridge history.           |
| `bridge`  | `<FROM> <TO> <amount> [--path=native\|permit\|approve] [--max-approve] [--confirm]` | PK   | tx (or permit) | Execute the bridge.            |