Developers · SDK

@usdctofiat/offramp は、関数を1回呼び出すだけでUSDCオフランプを追加します。

このSDKは、自前のアプリからUSDCを売却する最短の経路です。1回の呼び出しで、入力の検証、USDCの承認、売り手の登録、Base上での入金作成、価格決定の委任までを行います。Baseメインネットを対象とし、入金作成はパーミッションレスです。

npmからインストールスターターをクローン
01

インストールして入金を作成する

  1. 01パッケージをインストール: bun add @usdctofiat/offramp（npmやpnpmも利用可能）。
  2. 02viemのWalletClientを渡す: ユーザーのウォレット、サーバーウォレット、またはボットウォレット。
  3. 03offramp(walletClient, { amount, platform, currency, identifier }) を呼び出す。
  4. 04返される depositId と txHash を読み取るか、npx create-offramp-app@latest でプロジェクトを足場立てする。
02

SDKのサーフェス

エクスポート機能
offramp(walletClient, params){ depositId, txHash, resumed, otcLink? } を返す、1回呼び出しのUSDC売却フロー
deposits(address)プロトコル状態をインデックスせずに、あるアドレスの入金を一覧表示
close(walletClient, depositId)既存の入金から未約定のUSDCを引き出す
enableOtc / disableOtc / getOtcLink入金に対する一買い手限定のプライベート制限を管理
useOfframp() / usePeerExtensionRegistration()@usdctofiat/offramp/react のReactフック
PLATFORMS, CURRENCIES識別子・検証・通貨リストを備えた型付きconstマップ
03

設計段階から再開可能

入金の作成は複数のオンチェーンステップにまたがります。前回の呼び出しで入金が途中の状態のまま残っている場合、offramp() を再度呼び出すと、重複を作成するのではなく中断したところから再開します。既存の未委任の入金が作成ではなく引き継がれた場合、結果の resumed フラグが true になります。

これにより、サーバーやボットからの再試行も安全です。クリーンな状態を前提にするのではなく、オンチェーンの状態と照合する、冪等性に優しいエントリーポイントです。

04

エラー処理

関心事SDKが知らせる方法
型付きエラーOfframpError は OFFRAMP_ERROR_CODES のコードを持つ
PayPalまたはWiseのセットアップEXTENSION_REGISTRATION_REQUIRED は技術的な設定のみを通知します。プロバイダーポリシーを個別に適用する
検証PLATFORMS と CURRENCIES が識別子と通貨の検証を提供
鍵の保管なしSDKはあなたの WalletClient で署名し、秘密鍵を保存することはない
05

次に進む先

スターターテンプレート

Next.js, Vite, and Telegram-bot starters plus runnable scripts.

Peerlytics API

Fetch route, orderbook, deposit, and intent context.

コードでプライベートOTC

入金を承認済みの一買い手ウォレットに限定し、リンクを共有。

探索を続けてください

Peerlytics API開発者ハブ

よくある質問

@usdctofiat/offramp は無料ですか？

Yes. The SDK is free to install and integrate, and creating deposits needs no API key because your wallet signs. Peerlytics analytics and API credits are available separately through Peerlytics.

SDKは鍵を保管したり法定通貨を動かしたりしますか？

どちらもしません。あなたが提供するviemのWalletClientで署名し、秘密鍵を保持することはありません。法定通貨は選択した決済アプリ上で買い手と売り手の間で直接移動し、SDKはオンチェーンのUSDCと入金のライフサイクルのみを扱います。

統合をテストするにはどうすればよいですか？

公開サンドボックスはありません。SDKはBaseメインネットを対象とするため、テスト用の入金も実物であり、公開オーダーブック上で発見可能です。最小1 USDCを使い、OTC入金として制限する（otcTaker を渡してあなたのウォレットだけが約定できるようにする）か、すぐに close() してください。オンチェーンと deposits() で確認しましょう。