SDK 퀵스타트

@stablechain/sdk를 설치하고, 개인 키로 서명된 클라이언트를 생성하고, Stable 테스트넷에서 USDT0 트랜스퍼를 전송하고, 메인넷 브릿지 견적을 가져옵니다. 총 소요 시간: 약 5분.

전제 조건

Node.js 20 이상
테스트넷 USDT0가 있는 테스트 개인 키. 테스트넷 지갑에 자금 조달을 참조하십시오.

1. 설치

mkdir stable-sdk-quickstart && cd stable-sdk-quickstart
npm init -y && npm pkg set type=module
npm install @stablechain/sdk viem dotenv

added 3 packages, audited 4 packages in 2s

type=module을 사용하면 아래 단계에서 최상위 await를 사용할 수 있습니다. type=module이 없으면 tsx가 스크립트를 거부합니다.

테스트 키를 저장합니다:

echo "PRIVATE_KEY=0xYOUR_TEST_KEY" > .env

2. 클라이언트 생성

index.ts를 생성합니다:

import "dotenv/config";
import { createStable, Network } from "@stablechain/sdk";
import { privateKeyToAccount } from "viem/accounts";
 
const account = privateKeyToAccount(process.env.PRIVATE_KEY as `0x${string}`);
 
const stable = createStable({
  network: Network.Testnet,
  account,
});
 
console.log("Signer:", account.address);

Signer: 0xYourAddress

createStable은 세 가지 서명 모드를 허용합니다: account(서버 측, 위에 표시됨), transport(custom(window.ethereum)을 통한 브라우저 지갑), 또는 walletClient(미리 구축된 viem WalletClient). 세 가지 모두에 대한 자세한 내용은 viem과 함께 SDK 사용을 참조하십시오.

3. USDT0 전송 보내기

index.ts에 추가합니다:

const { txHash } = await stable.transfer({
  from: account.address,
  to: "0x000000000000000000000000000000000000dEaD",
  amount: 0.001,
});
 
console.log("Transfer:", txHash);

실행합니다:

npx tsx index.ts

Signer: 0xYourAddress
Transfer: 0x8f3a...2d41

테스트넷 익스플로러에서 해시를 열어 확인합니다.

4. 브릿지 견적

브릿지 및 스왑 라우팅은 Stable 메인넷을 지원하지만 테스트넷은 지원하지 않는 LI.FI를 통해 이루어집니다. quoteBridge는 읽기 전용 호출이므로 (서명, 가스, 자금 필요 없음) 동일한 키로 메인넷 브릿지 견적을 미리 볼 수 있습니다. 추가합니다:

import { Chain } from "@stablechain/sdk";
 
const stableMainnet = createStable({
  network: Network.Mainnet,
  account,
});
 
const bridgeQuote = await stableMainnet.quoteBridge({
  fromChain: Chain.Ethereum,
  toChain: Chain.Stable,
  fromToken: "0xdAC17F958D2ee523a2206206994597C13D831ec7", // Ethereum의 USDT
  toToken: "0x779Ded0c9e1022225f8E0630b35a9b54bE713736", // Stable의 USDT0
  amount: 100,
});
 
console.log("Bridge quote:", bridgeQuote);

Bridge quote: { toAmount: 99.73 }

견적을 stableMainnet.bridge({ ...params, quote })에 전달하여 실행합니다. 라우팅은 LI.FI를 통해 이루어지며, LI.FI는 브릿지 경로를 선택합니다. SDK는 승인 및 체인 전환을 처리합니다.

5. 스왑

동일 체인 스왑은 동일한 패턴을 따릅니다: stable.quoteSwap은 예상 출력 및 미리 구축된 트랜잭션을 반환하고, stable.swap({ ...params, quote })는 ERC-20 승인을 내부적으로 처리하여 실행합니다.

다음 권장 사항

SDK 참조: 모든 매개변수, 반환 유형 및 오류 클래스.
SDK로 수익 창출: 메인넷 볼트에 USDT0를 예치하고, APY 및 포지션을 확인하고, 인출합니다.
viem과 함께 사용: 개인 키, 브라우저 지갑 및 미리 구축된 WalletClient 서명 간에 전환합니다.
wagmi와 함께 사용: wagmi 훅을 사용하여 React 앱에 SDK를 연결합니다.