Stable 엔터프라이즈 SDK

@stablechain/enterprise는 Stable의 엔터프라이즈 트랜잭션 레일을 위한 서버 측 TypeScript 클라이언트입니다. 가스 면제 트랜잭션(사용자의 가스를 후원)과 보장된 블록 공간 트랜잭션(예약된 엔터프라이즈 레인에 포함)의 두 가지 유형의 특권 트랜잭션을 서명하고 릴레이합니다. 한 클라이언트에서 두 레일 중 하나 또는 둘 다를 활성화할 수 있습니다.

import { createStableEnterprise, stable } from "@stablechain/enterprise";
import { privateKeyToAccount } from "viem/accounts";
 
const enterprise = createStableEnterprise({
  chain: stable,
  gasWaiver: { account: privateKeyToAccount("0xYOUR_WAIVER_KEY") },
});
 
const { txHash } = await enterprise.gasWaiver.send(user, { to: token, data });

txHash: 0x8f3a...2d41

호출은 래퍼 트랜잭션이 아닌 사용자 트랜잭션의 해시인 H_inner를 반환합니다.

SDK의 기능

SDK는 모듈당 하나씩 세 가지 기능을 노출합니다. 각 기능은 선택 사항이며 독립적으로 구성되며, 각 기능에는 자체 서명 계정이 있어 별도의 키를 사용할 수 있습니다.

가스 면제 릴레이 (gasWaiver): 가스 면제 트랜잭션을 구축하고 서명하며 릴레이합니다. 화이트리스트에 등록된 면제 계정은 사용자의 제로 가스 트랜잭션을 래핑하여 사용자가 USDT0를 보유하지 않고도 트랜잭션을 수행할 수 있도록 합니다. 가스 면제를 참조하세요.
보장된 블록 공간 (guaranteedBlock): 엔터프라이즈 RPC 게이트웨이를 통해 트랜잭션을 릴레이하여 예약된 엔터프라이즈 레인 블록 공간에 포함되도록 합니다. 가스 면제와 달리 서명자는 자체 가스를 지불합니다. 보장된 블록 공간을 참조하세요.
보장된 릴레이 트랜잭션 (guaranteedWaiver): 두 가지를 모두 결합합니다. 엔터프라이즈 블록 공간을 통해 라우팅되는 가스 면제 트랜잭션이므로 사용자는 잔액이 필요 없으며 트랜잭션은 여전히 엔터프라이즈 레인에 포함됩니다.

모든 기능은 동일한 네 가지 메서드를 제공합니다. SDK가 서명하는 커스터디 경로의 경우 send 및 sendBatch를, 사용자가 다른 곳에서 서명하고 서명된 헥스만 전달하는 비커스터디 경로의 경우 relay 및 relayBatch를 제공합니다.

SDK는 npm에 @stablechain/enterprise로 게시되어 있으며 현재 버전 1.0.0이며, 피어 종속성으로 viem >= 2.0.0이 필요합니다.

액세스

엔터프라이즈 SDK는 Stable 메인넷 및 Stable 테스트넷에서 사용할 수 있습니다. 클라이언트의 chain으로 메인넷의 경우 stable을, 테스트넷의 경우 stableTestnet을 전달합니다. 둘 다 패키지에서 다시 내보내집니다.

두 레일 모두 게이트로 보호됩니다. 가스 면제는 거버넌스에 등록된 면제 키를 필요로 하며, 보장된 블록 공간은 엔터프라이즈 RPC 게이트웨이 API 키를 필요로 합니다. 통합하려면 Stable에 문의하여 액세스 권한을 얻으세요. Stable은 필요한 면제 키와 게이트웨이 엔드포인트를 제공합니다.

서버 측 전용

면제 키는 화이트리스트에 등록된 거버넌스 등록 계정입니다. 이를 보유한 누구든지 귀하의 정책에 따라 가스를 후원할 수 있습니다. 엔터프라이즈 RPC 게이트웨이 URL에는 API 키가 포함되어 있습니다. 둘 다 비밀로 취급하세요. 면제 키를 프로세스 외부에서 유지하려면 AWS KMS와 같은 커스터디 서명자로 백업하세요. 서명 키 및 커스터디를 참조하세요.

언제 사용해야 할까요?

백엔드를 운영하고 사용자 가스를 후원하거나 자체 트래픽에 대한 포함을 보장하려는 경우 엔터프라이즈 SDK를 사용하세요. 백엔드 또는 브라우저에서 일상적인 전송, 브릿지, 스왑 및 볼트 수익의 경우 범용 Stable SDK를 대신 사용하세요.

여기서 시작

가스 면제로 릴레이: 사용자의 가스를 후원하여 USDT0를 보유하지 않고도 트랜잭션을 수행할 수 있도록 합니다.
보장된 트랜잭션 전송: 예약된 엔터프라이즈 레인 블록 공간에 트랜잭션을 포함합니다.
보장된 릴레이 트랜잭션: 두 레일을 모두 결합합니다. 엔터프라이즈 레인의 가스 면제 트랜잭션입니다.
엔터프라이즈 SDK 참조: 모든 모듈, 메서드, 구성 옵션 및 오류 클래스입니다.

다음 권장 사항

npm에서 설치: npmjs.com에서 패키지를 보고 최신 버전을 확인합니다.
가스 면제 프로토콜: 트랜잭션 형식, 마커 라우팅 및 거버넌스 제어.
Stable SDK: 전송, 브릿징, 스왑 및 수익을 위한 범용 클라이언트.
Stable에 연결: 메인넷 및 테스트넷의 체인 ID, RPC 엔드포인트 및 탐색기.