# Stable > Explore Stable docs to integrate stablecoin payments, liquidity, and infrastructure securely into your platform. ## Docs - [Stable 통합하기](/ko): Stable은 USDT0가 네이티브 가스 토큰이자 ERC-20인 레이어 1입니다. 단일 슬롯 완결성, 1초 미만의 블록 타임, 그리고 완전한 EVM 호환성을 갖추고 있습니다. 지갑, 시드 문구, USDT0만 준비하면 됩니다. - [USDT0을 Stable로 브릿지하기](/ko/tutorial/bridge-usdt0): 이 튜토리얼에서는 TypeScript와 ethers v6를 사용하여 Ethereum Sepolia에서 Stable Testnet으로 USDT0를 프로그래밍 방식으로 브릿지합니다. 단계마다 함수를 하나씩 추가하면서 스크립트를 점진적으로 구축합니다. - [빠른 시작](/ko/tutorial/quick-start): 필요한 도구는 Node.js, 포셋에서 받은 USDT0, 그리고 개인 키뿐입니다. Stable은 USDT0를 가스 토큰으로 사용하므로, 트랜잭션을 처리하는 데 USDT0만 있으면 됩니다. 별도로 충전해야 할 가스 자산은 없습니다. - [SDK 빠른 시작](/ko/tutorial/sdk-quickstart): `@stablechain/sdk`를 설치하고, 개인 키로 서명하는 클라이언트를 만들고, Stable Testnet에서 USDT0 전송을 보내고, 브리지 및 스왑 견적을 가져옵니다. 총 소요 시간: 약 5분. - [첫 USDT0 보내기](/ko/tutorial/send-usdt0): Stable에서 USDT0는 체인의 네이티브 자산이자 ERC-20 토큰입니다. 이는 표준 가치 전송과 함께 `approve`, `transferFrom`, `permit`가 완전히 사용 가능하며, 두 경로 모두 동일한 기본 잔액에서 자금을 이동시킨다는 것을 의미합니다. - [스마트 컨트랙트 배포하기](/ko/tutorial/smart-contract): 이 튜토리얼에서는 간단한 스마트 컨트랙트를 Stable 테스트넷에 배포하고 체인에서 해당 상태를 읽어옵니다. 그 과정에서 Stable 네트워크가 어떻게 구성되어 있는지, USDT0가 가스 토큰으로 어떻게 작동하는지, 그리고 표준 EVM 도구를 Stable로 가리키는 방법을 배우게 됩니다. - [Brand Kit](/ko/resources/brand-kit): 아래에서 Stable 브랜드 키트를 확인하실 수 있습니다. 이 키트에는 다양한 형식의 로고와 컬러 팔레트가 포함되어 있으며, 프로젝트나 커뮤니케이션에서 Stable의 브랜딩을 일관되게 유지할 수 있도록 설계되었습니다. - [퍼실리테이터](/ko/reference/agentic-facilitators): 퍼실리테이터는 서명된 x402 결제를 검증하고, 이를 Stable에서 USDT0로 정산하는 온체인 호출을 제출합니다. 호스팅된 퍼실리테이터를 사용하면 정산 인프라를 운영하거나 가스 토큰을 관리할 필요가 없습니다. 레일 수준의 맥락은 [에이전트 정산](/ko/explanation/agent-settlement)을 참조하세요. - [지갑](/ko/reference/agentic-wallets): 에이전트 지갑은 AI 에이전트와 자율 시스템에 자기수탁형 서명 기능을 제공하여, 사람이 직접 설정하지 않아도 x402 결제 흐름에 참여할 수 있도록 합니다. - [Bank precompile 참조](/ko/reference/bank-module-api): **개념:** bank 모듈이 무엇을 하고 언제 사용하는지에 대해서는 [Bank 모듈](/ko/explanation/bank-module)을 참조하세요. - [브리지](/ko/reference/bridges): Stable로 USDT0를 송수신하는 것을 지원하는 브리지 제공자입니다. 크로스체인 USDT0 이동이 어떻게 작동하는지는 [Stable로 브리징하기](/ko/explanation/usdt0-bridging)를 참조하세요. 실습 가이드는 [USDT0를 Stable 테스트넷으로 브리징하기](/ko/tutorial/bridge-usdt0) 튜토리얼을 참조하세요. - [연결](/ko/reference/connect): 이 페이지는 Stable에 연결하는 데 필요한 네트워크 세부 정보를 통합해 제공합니다. - [수탁(Custody)](/ko/reference/custody): **MPC 수탁 인프라:** 다자간 연산(multi-party computation)을 활용하여 여러 당사자에게 개인 키 제어 권한을 분산하는 플랫폼입니다. 이러한 플랫폼은 기관용 디지털 자산 운영을 위한 안전한 키 관리, 정책 엔진, 개발자 API를 제공합니다. - [개발자 지원](/ko/reference/developer-assistance): 다음과 같은 주제를 다루는 개발자 중심 질문 모음집입니다: - [DEX](/ko/reference/dexes): 현물 거래, 유동성 공급 및 온체인 라우팅을 위한 Stable의 DEX 배포입니다. Stable은 [공식 Uniswap v3 배포 목록](https://gov.uniswap.org/t/official-uniswap-v3-deployments-list/24323/13#p-58106-stable-4)에 등재되어 있습니다. Stable의 Uniswap v3 컨트랙트는 거버넌스에서 표준으로 인정받았으며 기본 프론트엔드인 [Stable Swap](https://swap.stable.xyz)을 통해 라우팅됩니다. - [Distribution precompile 참조](/ko/reference/distribution-module-api): **개념:** distribution 모듈이 무엇을 하는지와 언제 사용하는지에 대해서는 [Distribution 모듈](/ko/explanation/distribution-module)을 참조하세요. - [EIP-7702](/ko/reference/eip-7702-api): Stable은 **EIP-7702**를 지원하며, 이를 통해 EOA가 자신의 계정 코드를 기존 스마트 컨트랙트로 설정할 수 있습니다. EOA는 원래의 주소와 프라이빗 키를 유지하면서 위임 대상의 로직을 실행합니다. - [FAQ](/ko/reference/faq): **Stable이란 무엇인가요?** - [가스 가격 책정 참조](/ko/reference/gas-pricing-api): Stable에서의 트랜잭션 구성, 가스 추정, 도구 설정. - [가스 면제 프로토콜](/ko/reference/gas-waiver-api): 이 문서는 가스 면제 메커니즘을 설명합니다: 트랜잭션 형식, 마커 라우팅, 거버넌스 제어, 그리고 Waiver Server API. - [인덱서](/ko/reference/indexers): 인덱서와 분석 플랫폼은 온체인 데이터에 대한 구조화된 접근을 제공하여, 개발자가 트랜잭션, 잔액, 로그, 이벤트, 애플리케이션별 데이터를 대규모로 쿼리할 수 있게 합니다. Stable은 EVM 호환이므로 표준 Ethereum 인덱싱 도구가 원활하게 작동합니다. - [인보이스 정산](/ko/reference/invoices): 각 인보이스는 인보이스 메타데이터(인보이스 번호, 당사자, 금액, 만기일)에서 파생된 고유하고 결정론적인 nonce에 매핑됩니다. 이 nonce는 [ERC-3009](/ko/explanation/erc-3009)를 통해 정산을 구동하며, 기존 회계 시스템과 대사할 수 있는 변경 불가능한 영수증을 생성합니다. - [JSON-RPC API](/ko/reference/json-rpc-api) - [메인넷 정보](/ko/reference/mainnet-information): Stable 메인넷에 접속하기 위해 알아야 할 모든 정보입니다. - [버전 기록](/ko/reference/mainnet-version-history): Stable 메인넷의 전체 버전 기록 및 관련 문서입니다. - [네트워크 라우팅](/ko/reference/network-routing): Stable의 애플리케이션을 위한 연결성과 데이터 전송을 최적화하는 네트워크 라우팅 제공업체입니다. - [네트워크 업그레이드](/ko/reference/network-upgrades) - [운영](/ko/reference/node-operations-overview): 운영은 Stable 노드 실행을 다룹니다: 풀 노드 또는 아카이브 노드, 테스트넷 또는 메인넷, 설치부터 모니터링까지. 노드가 적용하는 체인 수준 동작(수수료 모델, 파이널리티, 가스로서의 USDT0)에 대해서는 [가스 가격 책정](/ko/explanation/gas-pricing), [파이널리티](/ko/explanation/finality), [아키텍처 개요](/ko/explanation/core-optimization-overview)를 참조하세요. - [오라클](/ko/reference/oracles): 오라클은 자산 가격과 같은 오프체인 데이터를 스마트 컨트랙트에 제공합니다. RedStone은 Stable에서 가격 피드를 운영합니다. - [USDT0 보내기 및 받기](/ko/reference/p2p-payments): Stable에서는 P2P 결제가 1초 이내에 정산됩니다. 사용 사례에 따라 두 가지 전송 방식을 사용할 수 있습니다. - [API 요청별 과금](/ko/reference/pay-per-call): [x402](/ko/explanation/x402) 미들웨어를 사용하여 요청별 가격 책정으로 모든 HTTP 엔드포인트를 수익화하세요. 서버는 가격을 선언하고, 클라이언트는 호출마다 결제하며, 정산은 요청 수명 주기 내에서 이루어집니다. 계정도, API 키도, 청구 주기도 필요 없습니다. - [램프](/ko/reference/ramps): 온/오프 램프 파트너는 Stable을 글로벌 법정화폐 시스템에 연결하여 사용자와 기업이 USDT, 현지 통화, 결제 레일 간에 자금을 이동할 수 있게 합니다. - [RPC 제공자](/ko/reference/rpc-providers): Stable을 지원하는 RPC 및 개발자 인프라 제공자입니다. - [SDK 레퍼런스](/ko/reference/sdk): `@stablechain/sdk`의 전체 표면. 단계별 안내는 [SDK 빠른 시작](/ko/tutorial/sdk-quickstart)을 참조하세요. - [스테이킹 프리컴파일 레퍼런스](/ko/reference/staking-module-api): **개념:** 스테이킹 모듈이 무엇을 하는지와 언제 사용하는지는 [스테이킹 모듈](/ko/explanation/staking-module)을 참고하세요. - [정기 결제 설정하기](/ko/reference/subscriptions): 풀(pull) 기반 구독을 사용하면 구독자가 매번 결제를 직접 시작하지 않아도 서비스 제공자가 정해진 일정에 따라 결제를 수금할 수 있습니다. - [시스템 모듈 참조](/ko/reference/system-modules-api-overview): Stable은 가스 효율성과 예측 가능한 제어를 위해 **프리컴파일된 컨트랙트(precompiled contracts)** 로 구현된 **시스템 모듈(System Modules)** 을 통해 핵심 결제 동작을 노출합니다. - [시스템 트랜잭션 레퍼런스](/ko/reference/system-transactions-api): **개념:** 시스템 트랜잭션이 SDK 이벤트를 EVM에 어떻게 연결하며 왜 중요한지에 대해서는 [시스템 트랜잭션](/ko/explanation/system-transactions)을 참조하세요. - [생태계](/ko/reference/testnet-ecosystem): 이 문서에서는 브릿지(LayerZero) 및 USDT0에 대한 정보를 확인할 수 있습니다. - [테스트넷 정보](/ko/reference/testnet-information): Stable 테스트넷에 접속하기 위해 알아야 할 모든 것입니다. - [버전 기록](/ko/reference/testnet-version-history): Stable 테스트넷의 전체 버전 기록 및 관련 문서입니다. - [토크노믹스](/ko/reference/tokenomics): Stable은 스테이블코인 결제, 엔터프라이즈급 결제 및 USDT 중심 인프라에 최적화된 고성능 레이어 1 블록체인입니다. - [지갑](/ko/reference/wallets): **사용자 지갑:** 모바일 앱, 브라우저 확장 프로그램, 거래소 연동 지갑과 같은 전통적인 소비자용 지갑입니다. 사용자가 USDT를 보관하고, 전송하고, dApp에 연결하며, Stable과 직접 상호작용할 수 있게 합니다. - [EIP-7702를 활용한 계정 추상화](/ko/how-to/account-abstraction): 이 가이드는 EOA에 EIP-7702를 적용하고 위임을 사용하여 세 가지 패턴, 즉 일괄 결제, 지출 한도, 세션 키를 구현하는 과정을 단계별로 설명합니다. EOA는 그 과정 내내 자신의 주소와 개인 키를 유지합니다. - [Stable에서 MPP 엔드포인트 구축하기](/ko/how-to/build-mpp-endpoint): 이 가이드는 Stable에서 USDT0를 위한 커스텀 [MPP](/ko/explanation/mpp) 결제 메서드를 작성하고 MPP로 보호되는 엔드포인트를 제공하는 과정을 설명합니다. 구매자는 [ERC-3009](/ko/explanation/erc-3009) `transferWithAuthorization`에 서명하고, 서버는 `mppx`의 `verify()` 훅을 통해 이를 검증하며, 정산은 여러분이 제어하는 별도의 단계에서 이루어집니다. - [P2P 결제 배우기](/ko/how-to/build-p2p-payments): 이 가이드는 Stable에서 P2P 결제 애플리케이션을 구축하는 과정을 안내합니다. 이 앱은 결제의 전체 수명 주기를 처리합니다. 발신자는 USDT0를 직접 전송하고, 수신자는 들어오는 결제를 실시간으로 감지하며, 양쪽 모두 자신의 거래 내역을 조회할 수 있습니다. 모바일 앱이든 웹 체크아웃이든 백엔드 서비스든, 모든 지갑이나 결제 인터페이스와 동일한 아키텍처입니다. - [유료 호출 API 구축하기](/ko/how-to/build-pay-per-call): 이 가이드는 x402로 API 엔드포인트를 수익화하는 과정을 안내합니다. 서버는 결제 핸들러를 추가하고, 클라이언트는 요청마다 비용을 지불하며, 정산은 HTTP 라이프사이클 내에서 이루어집니다. - [지갑 생성하기](/ko/how-to/create-wallet): Stable 지갑은 이더리움 표준 키 쌍입니다. EVM 계정을 생성하는 모든 지갑 라이브러리는 수정 없이 Stable에서 작동합니다. 이 가이드에서는 두 가지 경로를 소개합니다: 대부분의 애플리케이션을 위한 ethers.js, 그리고 에이전트와 결제를 위한 턴키 방식의 자가 수탁(self-custody) 계층을 원하는 통합을 위한 Tether의 [WDK (Wallet Development Kit)](https://github.com/tetherto/wdk)입니다. - [컨트랙트 이벤트 인덱싱](/ko/how-to/index-contract): 인덱싱은 온체인 이벤트를 애플리케이션이 반응할 수 있는 데이터로 변환합니다: 잔액 업데이트, 거래 내역, UI 알림 등이 그 예입니다. 이 가이드에서는 ethers.js를 사용해 배포된 Stable 컨트랙트의 이벤트를 구독하는 방법과, 서비스가 오프라인 상태일 때 발생한 이벤트를 놓치지 않도록 과거 이벤트를 백필하는 방법을 설명합니다. - [검증자 데이터 인덱싱](/ko/how-to/index-validator-data): 검증자 데이터는 온체인에 존재하며 표준 EVM JSON-RPC로 읽을 수 있습니다. 스테이킹, 슬래싱, 거버넌스 프리컴파일을 통해 현재 상태를 조회하고, 이들의 이벤트 로그로부터 이력을 재구성합니다. 즉, 인덱서나 분석 플랫폼은 노드의 `stabled` CLI나 Cosmos REST에 접근하지 않고도 `eth_call`과 `eth_getLogs`만으로 필요한 모든 것을 읽습니다. - [가스 없는 트랜잭션 활성화](/ko/how-to/integrate-gas-waiver): Gas Waiver는 Stable에서 가스 없는 트랜잭션을 가능하게 합니다. Gas Waiver를 사용하면 애플리케이션이 사용자를 대신해 가스 수수료를 부담하므로, 사용자는 가스용 USDT0을 보유하지 않고도 컨트랙트와 상호작용할 수 있습니다. - [인보이스로 결제하기](/ko/how-to/pay-with-invoice): 이 가이드는 인보이스 메타데이터에서 파생된 결정적 nonce를 사용하여 [ERC-3009](/ko/explanation/erc-3009)로 온체인에서 인보이스를 정산하는 과정을 안내합니다. nonce는 각 결제를 해당 인보이스에 연결하고 이중 결제를 방지합니다. - [MCP 서버로 결제하기](/ko/how-to/pay-with-mcp): 이 가이드는 x402가 활성화된 API를 [MCP](https://modelcontextprotocol.io) 도구에 연결하여 AI 클라이언트가 자연어 프롬프트를 통해 이를 호출하고 비용을 지불할 수 있도록 하는 방법을 보여줍니다. 이는 [호출당 결제 API 구축하기](/ko/how-to/build-pay-per-call)의 서버를 기반으로 합니다. - [프로덕션 준비 상태](/ko/how-to/production-readiness): 테스트넷에서 메인넷으로 전환하기 전에 아래 각 섹션을 순서대로 검토하세요. - [viem과 함께 SDK 사용하기](/ko/how-to/sdk-with-viem): `@stablechain/sdk`는 viem 기반으로 만들어졌습니다. `createStable`은 세 가지 서명 모드를 지원하며, 코드가 실행되는 위치에 따라 하나를 선택합니다: 프라이빗 키를 사용하는 서버 측, 사용자 지갑을 사용하는 브라우저 측, 또는 이미 구성한 `WalletClient`(예: wagmi 앱에서)를 사용하는 방식입니다. - [wagmi와 함께 SDK 사용하기](/ko/how-to/sdk-with-wagmi): `createStable`은 viem `WalletClient`를 받는데, 이는 wagmi의 `useWalletClient`가 반환하는 것과 정확히 일치합니다. 평소처럼 wagmi를 통해 지갑을 연결한 다음, 지갑 클라이언트가 변경될 때마다 `StableClient`를 메모이즈합니다. - [자체 호스팅 가스 면제](/ko/how-to/self-hosted-gas-waiver): 자체 호스팅 가스 면제를 사용하면 호스팅된 Waiver Server API 대신 직접 면제 인프라를 운영할 수 있습니다. 온체인 거버넌스를 통해 면제 주소를 등록한 다음, 래퍼 트랜잭션을 네트워크에 직접 브로드캐스트합니다. - [구독 및 수금](/ko/how-to/subscribe-and-collect): 이 가이드는 구독자가 한 번 인증하면 서비스 제공자가 EIP-7702 계정 추상화를 통해 각 청구 주기마다 자동으로 수금하는 구독 결제 시스템을 구축하는 과정을 안내합니다. - [언본딩 완료 추적하기](/ko/how-to/track-unbonding): 언본딩 기간이 완료되면, 프로토콜은 시스템 트랜잭션을 통해 `StableSystem` 프리컴파일(`0x0000000000000000000000000000000000009999`)에서 `UnbondingCompleted` 이벤트를 발생시킵니다. 이를 통해 dApp은 커스텀 인덱서를 실행하거나 REST 엔드포인트를 폴링하지 않고도 사용자에게 실시간으로 알리고 잔액을 업데이트할 수 있습니다. - [Stable 테스트넷 지갑에 자금을 충전하는 방법](/ko/how-to/use-faucet): Stable은 USDT0를 가스 토큰으로 사용하므로, 체인과 상호작용하기 위해서는 지갑에 USDT0가 필요합니다. 먼저 Faucet을 사용하여 계정에 USDT0를 충전해야 합니다. - [시스템 모듈 사용하기](/ko/how-to/use-system-modules): Stable은 고정된 주소의 \*\*프리컴파일 컨트랙트(precompiled contracts)\*\*를 통해 프로토콜 수준의 정산 로직을 노출합니다. 프리컴파일을 사용하면 EVM 코드가 Stable SDK 모듈(스테이킹, 보상 분배, STABLE 토큰 작업)을 다시 구현하지 않고 호출할 수 있습니다. 프로토콜 수준에서 실행되기 때문에 동등한 Solidity 구현보다 가스 효율이 훨씬 높습니다. - [스마트 컨트랙트 검증하기](/ko/how-to/verify-contract): 검증은 컨트랙트의 소스 코드를 블록 탐색기에 업로드하고 배포된 바이트코드로 컴파일됨을 증명합니다. 검증이 완료되면, 사용자는 코드를 재호스팅하지 않고도 Stablescan에서 상태를 읽고, 함수를 호출하고, 소스를 감사할 수 있습니다. 이 가이드는 Stable에서 Foundry로 배포된 컨트랙트를 검증하는 과정을 안내합니다. - [USDT0를 가스로 사용하기](/ko/how-to/work-with-usdt-gas): Stable에서 USDT0는 체인의 네이티브 자산이자 ERC-20 토큰입니다. 가스 토큰은 별도의 네이티브 자산이 아닌 USDT0입니다. 표준 이더리움 가스 추정은 세 가지를 조정하면 그대로 작동합니다: `maxPriorityFeePerGas`는 항상 `0`이고, `baseFee`는 USDT0로 표기되며, 네이티브 전송에서 `value` 필드는 ETH가 아닌 USDT0를 담습니다. - [가스리스 트랜잭션](/ko/how-to/zero-gas-transactions): Gas Waiver를 사용하면 애플리케이션이 사용자를 대신해 가스를 부담할 수 있습니다. 사용자는 `gasPrice = 0`으로 트랜잭션에 서명하고, 거버넌스에 등록된 waiver가 이를 감싸며, 검증자는 사용자에게 비용이 들지 않게 호출을 실행합니다. 이 가이드는 조건을 충족하는 전송 과정을 살펴보고, 가스가 면제되었는지 확인하는 방법을 보여주며, waiver가 무엇을 다루고 다루지 않는지 설명합니다. - [계정 가이드](/ko/explanation/accounts-guides): 계정 탭 아래의 모든 가이드, 개념, 참조를 수행하려는 작업별로 분류했습니다. - [Stable의 계정](/ko/explanation/accounts-overview): Stable의 계정은 [EIP-7702 위임](/ko/explanation/eip-7702)을 통해 선택적으로 스마트 컨트랙트 로직을 실행할 수 있는 표준 이더리움 EOA입니다. 사용자는 지갑, 일괄 결제, 정기 구독, 세션 키 전반에 걸쳐 하나의 주소와 하나의 개인 키를 유지합니다. 에이전트는 어떠한 커스터디 미들웨어 없이 동일한 계정 모델을 실행합니다. - [에이전트 정산](/ko/explanation/agent-settlement): 에이전트 정산은 머신 결제를 위한 Stable의 레일입니다. 에이전트는 USDT0 잔액을 보유하고, HTTP를 통해 리소스 비용을 지불하며, 결제는 동일한 요청 주기 안에서 온체인으로 정산됩니다. 에이전트는 결제와 네트워크 수수료 모두를 하나의 잔액에서 차감합니다. 별도의 가스 토큰도, 가입도, API 키 교체도 없습니다. - [AI 및 에이전트 가이드](/ko/explanation/ai-agents-guides): AI/에이전트 탭 아래의 모든 가이드, 개념 및 참조를 하려는 작업별로 그룹화했습니다. - [Autobahn](/ko/explanation/autobahn): 현대의 비잔틴 장애 허용(Byzantine Fault Tolerant, BFT) 합의 프로토콜은 일반적으로 부분 동기(partial synchrony) 모델에서 동작합니다. 이 모델은 어떤 시점 이후에는 네트워크가 안정되며 메시지 지연 시간이 유한하게 유지된다는 가정에 기반합니다. 이 모델은 프로토콜 설계에 있어 실용적으로 작용해 왔지만, 실제 운영 환경에서는 장기간 상태를 안정적으로 유지하기 어렵습니다. 대신 시스템은 지속적인 동기 구간과 간헐적인 장애(예: 레이턴시 증가, 노드 장애, 공격적 조건 등)를 반복적으로 겪습니다. 이러한 일시적 장애를 **"블립(blip)"** 이라고 합니다. - [Bank](/ko/explanation/bank-module): Stable SDK의 `x/bank` 모듈은 기본적인 토큰 관리 기능만 제공합니다. 모든 토큰은 제한 없이 다른 계정으로 전송될 수 있으며, 사용자는 다른 계정에 토큰 전송 권한을 위임할 수 없습니다. 이러한 이유로, `bank` precompile 컨트랙트는 Stable SDK의 기존 `x/bank` 모듈 위에 추가적인 권한 부여 및 위임 기능을 제공합니다. - [브리지 보안과 DVN](/ko/explanation/bridge-security): LayerZero 브리지의 보안은 한 체인에서 보낸 메시지가 다른 체인에서 발생했음을 확인하는 검증 계층만큼만 안전합니다. 그 계층이 바로 탈중앙화 검증자 네트워크(Decentralized Verifier Network, DVN)입니다. 이 페이지에서는 DVN이 무엇을 하는지, Stable이 자사 브리지에서 DVN을 어떻게 구성하는지, 그리고 단일 DVN의 손상이 왜 Stable을 위험에 빠뜨리지 않는지를 설명합니다. - [개요](/ko/explanation/build-overview): Stable이 처음이신가요? 먼저 [빠른 시작](/ko/tutorial/quick-start)을 실행하세요. 5분이면 테스트넷 트랜잭션을 전송하므로, 이 탭의 나머지 내용을 연결할 무언가가 생깁니다. - [기밀 전송](/ko/explanation/confidential-transfer): 기업들 사이에서 블록체인 채택이 특히 스테이블코인 분야에서 가속화됨에 따라, 트랜잭션 프라이버시에 대한 수요도 점점 증가하고 있습니다. 기업들은 종종 결제 금액과 같은 민감한 데이터를 보호하기 위해 금융 운영에서 기밀성을 요구합니다. 이러한 요구를 해결하기 위해 Stable은 프라이버시 요구와 규제 준수라는 두 가지 필수 요소의 균형을 맞춘 기밀 전송 메커니즘을 개발 중입니다. - [합의](/ko/explanation/consensus): Stable Blockchain은 CometBFT를 기반으로 구축된 맞춤형 PoS 합의 프로토콜인 **StableBFT**를 활용하여 높은 처리량, 낮은 지연 시간, 그리고 강력한 신뢰성을 제공합니다. StableBFT는 결정론적 완결성(블록은 포함되는 즉시 최종 확정되며 포크가 없음)과 검증자의 1/3까지 장애가 발생하거나 악의적으로 행동하더라도 견딜 수 있는 비잔틴 장애 허용성을 제공합니다. - [컨트랙트 가이드](/ko/explanation/contracts-guides): 컨트랙트 탭 아래의 모든 가이드, 개념, 레퍼런스를 작업 목적별로 분류했습니다. - [Stable의 컨트랙트](/ko/explanation/contracts-overview): Stable은 완전히 EVM 호환됩니다. Solidity, Vyper, Hardhat, Foundry, ethers.js, viem이 변경 없이 작동합니다. 도구를 Stable의 RPC로 가리키기만 하면 기존 컨트랙트가 그대로 배포됩니다. 표준 EVM 위에, Stable은 프로토콜 수준 모듈(Bank, Distribution, Staking)을 고정 주소의 프리컴파일된 컨트랙트로 노출하므로, Solidity에서 스테이킹과 보상 분배를 다시 구현하지 않고도 호출할 수 있습니다. - [핵심 개념](/ko/explanation/core-concepts): 빌드를 시작하기에는 네 가지 개념으로 충분합니다. 각 섹션은 개념을 정의하고, 보여주며, 전체 레퍼런스로 연결합니다. - [개요](/ko/explanation/core-optimization-overview): 제출부터 결과 완결까지 블록체인 트랜잭션의 라이프사이클은, 강하게 연결된 여러 단계로 구성되어 있습니다. 트랜잭션은 **RPC** 인터페이스를 통해 제출되어, **멤풀**에 추가되고, 블록에 포함되며, **합의**를 통해 검증되고, **상태 머신**에 의해 실행되며, **데이터베이스**에 최종 저장됩니다. 전체 파이프라인을 모두 완료한 이후에야 사용자는 확정된 결과를 받을 수 있습니다. - [Distribution](/ko/explanation/distribution-module): `distribution` precompile 컨트랙트는 Stable SDK의 `x/distribution` 모듈 기능을 EVM 환경에서 사용할 수 있도록 브리지 역할을 합니다. - [EIP-7702](/ko/explanation/eip-7702): Stable은 **EIP-7702**를 지원하여 EOA(외부 소유 계정)가 임시로 스마트 계정처럼 작동할 수 있는 통합 계정 모델을 도입합니다. - [서명된 인가로 정산하기](/ko/explanation/erc-3009): ERC-3009는 토큰 보유자가 메시지에 서명하여 전송을 인가할 수 있게 합니다. 그러면 누구든지 그 서명된 인가를 제출하여 온체인에서 전송을 실행할 수 있습니다. 송신자는 컨트랙트를 직접 호출할 필요가 전혀 없습니다. - [Ethereum 비교](/ko/explanation/ethereum-comparison): Stable은 완전히 EVM과 호환되므로 대부분의 Ethereum 도구, 라이브러리, 컨트랙트 패턴이 수정 없이 작동합니다. 아래 섹션에서는 Ethereum에서 Stable로 옮길 때 동일하게 유지되는 것과 변경되는 것을 살펴봅니다. - [Ethereum 생태계와의 호환성](/ko/explanation/ethereum-compatibility): Stable은 Ethereum Virtual Machine (EVM)과 완벽하게 호환되어, 개발자들이 익숙한 도구, 라이브러리 및 컨트랙트 패턴을 수정 없이 사용할 수 있습니다. 이를 통해 기존 애플리케이션의 원활한 마이그레이션과 이미 Ethereum 생태계에서 개발 중인 팀의 간편한 온보딩을 보장합니다. - [실행](/ko/explanation/execution): **Stable EVM**은 Stable의 Ethereum 호환 실행 계층으로, MetaMask와 같은 기존 Ethereum 도구 및 지갑을 사용하여 체인과 원활하게 상호작용할 수 있도록 합니다. Stable EVM은 EVM의 개발자 경험과 StableSDK의 모듈러한 고성능 인프라를 결합합니다. - [Finality 규칙 및 호환성 보장](/ko/explanation/finality): Stable은 EVM 기반 실행 환경에서 트랜잭션을 처리합니다. 트랜잭션이 블록에 포함되면 그 효과가 상태에 적용되고 애플리케이션, 컨트랙트 및 인덱서에 즉시 표시됩니다. - [자금의 흐름](/ko/explanation/flow-of-funds): Stable은 스테이블코인 결제를 위해 특별히 설계된 최초의 블록체인입니다. 이 네트워크는 고처리량, 저지연 스테이블코인 거래에 최적화되어 있으며, USDT로 즉시 정산되는 P2P 결제와 가맹점 결제 수용을 제공합니다. 애플리케이션 계층의 가스 후원 및 면제를 통해 제공업체는 최종 사용자에게 수수료 없는 경험을 제공할 수 있으며, 블록체인 시스템의 복잡성을 추상화하면서 주류 결제 네트워크와 같은 느낌을 줍니다. - [Gas 가격 책정](/ko/explanation/gas-pricing): Stable은 단일 구성 요소 gas 수수료 모델을 사용합니다: - [Gas Waiver](/ko/explanation/gas-waiver): Gas Waiver는 소수의 거버넌스 승인 주소("면제자")가 `gasPrice = 0`인 트랜잭션을 제출할 수 있도록 허용하여 Stable에서 가스리스 최종 사용자 트랜잭션을 가능하게 합니다. Stable은 현재 파트너가 프로토콜별 래퍼 로직을 구현하지 않고도 가스리스 UX를 제공하기 위해 통합할 수 있는 면제자 서비스("면제자 서버")를 운영하고 있습니다. - [보장된 블록스페이스](/ko/explanation/guaranteed-blockspace): 스테이블코인이 지속적으로 진화함에 따라, 점점 더 많은 기업들이 이를 결제, 재무 흐름, 국경 간 정산 등 금융 운영에 통합하고 있습니다. 이러한 변화는 특히 안정적인 명목 화폐 접근이 제한된 지역에서 두드러집니다. 아프리카 및 라틴 아메리카와 같은 시장에서는 인플레이션과 환율 통제가 일반적이기 때문에, 스테이블코인은 운영 안정성을 위한 핵심 도구가 되고 있습니다. - [고성능 RPC](/ko/explanation/high-performance-rpc): 고성능 블록체인을 구현하기 위해서는 합의나 블록 생성만을 최적화해서는 충분하지 않습니다. RPC 계층은 블록체인과 사용자를 연결하는 인터페이스로, 사용자 경험에 있어 핵심적인 구성 요소입니다. Stable은 기존 RPC 설계의 한계를 극복하기 위해 새로운 RPC 전용 아키텍처를 제안합니다. - [개요](/ko/explanation/integrate-overview): Stable은 USDT0가 네이티브 가스 토큰인 EVM 호환 Layer 1입니다. 대부분의 이더리움 도구, 라이브러리, 컨트랙트 패턴은 수정 없이 작동합니다. RPC를 Stable로 지정하고 체인 ID를 전환하여 연결할 수 있습니다. - [주요 기능](/ko/explanation/key-features): Stable은 USDT 기반 활동을 원활하게 지원하기 위해 설계된 고성능 블록체인입니다. **위임 지분증명 (dPoS)** 메커니즘 위에 구축된 Stable은 **완전한 EVM 호환성**을 제공하며, **1초 미만의 블록 생성 시간**을 통해 빠르고 신뢰성 높은 트랜잭션 완결성을 달성합니다. **USDT에 특화**된 네트워크인 Stable은 사용자 경험을 최적화하는 다양한 USDT 전용 기능을 제공합니다. - [학습하기](/ko/explanation/learn-overview): [**개요**](/ko/explanation/overview) — Stable이 무엇이며 이 문서를 어떻게 읽어야 하는지 설명합니다. - [MPP 세션](/ko/explanation/mpp-sessions): 세션은 여러 개의 작은 결제를 하나의 온체인 정산으로 묶는 MPP 결제 인텐트입니다. 클라이언트는 에스크로에 자금을 한 번 예치한 후, 각 요청에 대해 저렴한 오프체인 바우처에 서명합니다. 온체인에서는 순액만 정산되므로, 스트리밍 워크로드에서 요청당 1센트 미만의 경제성을 실현할 수 있습니다. - [Machine Payments Protocol (MPP)](/ko/explanation/mpp): MPP(Machine Payments Protocol)는 HTTP 리소스를 요청하는 동일한 요청 내에서 결제할 수 있는 개방형 표준입니다. 이는 [x402](/ko/explanation/x402)를 새로운 결제 의도(charge, subscription, session), 멀티 레일 지원(스테이블코인, 카드, Lightning), 프로덕션 기능(멱등성, 본문 다이제스트 바인딩, 만료), 추가 전송 방식(MCP, WebSocket)으로 확장합니다. 이 프로토콜은 IETF 표준 트랙에 올라 있습니다. - [개요](/ko/explanation/overview): Stable은 USDT0가 네이티브 가스 토큰인 Layer 1이며, 표준 EVM 도구(Solidity, Foundry, Hardhat, ethers, viem, 그리고 `eth_*` JSON-RPC 메서드)가 변경 없이 작동합니다. - [활용 사례 개요](/ko/explanation/payment-use-cases-overview): Stable은 간단한 지갑 간 송금부터 에이전트 기반 서비스 결제까지 다양한 결제 패턴을 지원합니다. 아래 활용 사례는 오늘날 프로덕션에 바로 사용할 수 있는 패턴을 다룹니다. 곧 도입될 패턴(보장된 정산, 비공개 결제, 에이전트 간 상거래)에 대해서는 [예정된 활용 사례](/ko/explanation/upcoming-use-cases)를 참조하세요. - [결제 가이드](/ko/explanation/payments-guides): 결제 탭의 모든 가이드, 개념, 참조를 하려는 작업별로 그룹화했습니다. - [Stable의 결제](/ko/explanation/payments-overview): Stable은 결제를 중심으로 설계되었습니다. USDT0는 네이티브 자산이자 가스 토큰이므로, 정산과 수수료가 하나의 잔액을 공유합니다. 단일 슬롯 완결성(single-slot finality)은 송금이 1초 이내에 처리됨을 의미합니다. ERC-3009, EIP-7702, x402는 우회책이 아니라 네이티브 프리미티브입니다 — 서명으로 정산하거나, 위임된 계정에서 자금을 끌어오거나, 빌링 스택을 운영하지 않고도 HTTP 요청당 과금할 수 있습니다. - [Stable SDK](/ko/explanation/sdk-overview): `@stablechain/sdk`는 Stable을 위한 공식 TypeScript 클라이언트입니다. viem을 감싸서 가장 자주 사용하는 작업들을 위한 작고 타입이 지정된 API를 제공합니다: USDT0 전송, 체인 간 브리지, 그리고 Stable에서의 토큰 스왑. 라우팅, 승인, 소수점 처리, 체인 전환은 모두 자동으로 처리됩니다. - [StableDB](/ko/explanation/stable-db): 블록체인 성능에서 주요 병목 중 하나는 **디스크 I/O**에 있습니다. 보다 구체적으로는, 블록 실행 후 상태 데이터를 커밋하고 저장하는 작업이 핵심 병목 지점입니다. Stable은 이 문제를 해결하기 위해 `MemDB`, `VersionDB`, 메모리 매핑 파일 I/O 메커니즘 (`mmap`)와 같은 아키텍처 혁신을 도입하여 처리량을 획기적으로 향상시킵니다. - [Staking](/ko/explanation/staking-module): `staking` precompile 컨트랙트는 Stable SDK의 `x/staking` 모듈 기능을 EVM 환경에서 사용할 수 있도록 브리지 역할을 합니다. - [시스템 모듈](/ko/explanation/system-modules-overview): Stable의 핵심 프로토콜 동작은 SDK 모듈인 `x/bank`, `x/distribution`, `x/staking`에 존재합니다. 이 동작을 EVM에서 접근 가능하게 하기 위해, Stable은 각 모듈을 고정된 주소의 \*\*사전 컴파일된 컨트랙트(precompiled contract)\*\*로 노출합니다. Solidity로 작성된 컨트랙트는 precompile을 직접 호출하고, EVM은 그 호출을 네이티브 SDK 핸들러로 라우팅합니다. Precompile은 프로토콜 수준에서 구현되므로 동등한 Solidity 재구현보다 훨씬 가스 효율적입니다. - [System Transactions](/ko/explanation/system-transactions): 시스템 트랜잭션은 Stable 프로토콜이 Stable SDK 작업에 대한 EVM 이벤트를 발생시킬 수 있는 방법을 제공합니다. 언본딩 완료와 같은 스테이킹 이벤트가 SDK 계층에서 발생하면 프로토콜은 해당 이벤트를 발생시키는 EVM 트랜잭션을 자동으로 생성하여 이러한 작업이 EVM 도구 및 애플리케이션에 완전히 표시되도록 합니다. - [기술 개요](/ko/explanation/tech-overview): 상태 데이터베이스, 실행, 합의부터 USDT 전용 최적화에 이르기까지, Stable은 성능, 확장성, 신뢰성을 중점으로 설계되었습니다. Stable 스택의 각 구성 요소는 높은 처리량을 요구하는 워크로드 및 네트워크 전반에서 USDT 중심의 원활한 운영을 위해 최적화되어 있습니다. - [기술 로드맵](/ko/explanation/technical-roadmap): 사용자가 트랜잭션을 제출하기부터 결과를 받기까지의 라이프사이클은 여러 단계로 구성됩니다. 우선 트랜잭션은 RPC를 통해 전파되고, 멤풀에 저장되며, 블록에 포함된 다음, 합의를 통해 검증되고 실행되어, 마침내 데이터베이스에 결과 상태가 저장됩니다. 이러한 단계를 거쳐야만 사용자는 최종 결과를 받아볼 수 있습니다. - [다가오는 사용 사례](/ko/explanation/upcoming-use-cases): Stable은 단순 전송과 API 과금을 넘어서는 결제 패턴을 향해 구축하고 있습니다. 아래 사례들은 시간이 보장된 정산, 프라이버시를 보존하는 결제, 자율 에이전트 상거래를 다룹니다. 일부는 초기 형태로 오늘날에도 작동하며, 다른 일부는 현재 개발 중인 Stable 기능에 의존합니다. - [USDT as Gas](/ko/explanation/usdt-as-gas-token): Stable은 USDT 스테이블코인을 중심으로 구축되었습니다. USDT의 옴니체인 표현인 USDT0은 Stable 생태계를 지원하는 핵심 자산입니다. - [개요](/ko/explanation/usdt-features-overview): Stable은 USDT를 위해 제작된 레이어 1 블록체인입니다. 프로토콜의 모든 구성 요소는 USDT 전송에서의 마찰을 최소화하고, 세계에서 가장 많이 사용되는 스테이블코인에 특화된 고성능 환경을 제공하기 위해 설계되었습니다. - [USDT 전송 집계](/ko/explanation/usdt-transfer-aggregator): USDT 트랜잭션에 최적화된 블록체인으로써, Stable은 전반적인 시스템 반응성을 유지하면서도 매우 높은 수준의 토큰 전송량을 처리할 수 있도록 설계되었습니다. USDT 중심 성능과 일반 트랜잭션 다양성 간의 균형을 맞추기 위해, Stable은 USDT 전송 집계 메커니즘을 도입합니다. 이는 USDT0 전송을 고도로 병렬화되고 장애 허용적인 방식으로 번들링 및 처리하는 효율적이고 확장 가능한 솔루션입니다. - [Stable에서의 USDT0 동작](/ko/explanation/usdt0-behavior): **Ethereum에서 컨트랙트를 이식하려는 경우, 배포하기 전에 이 페이지를 읽으세요.** Stable에서 USDT0는 네이티브 가스 토큰이자 동일한 잔액에 대한 ERC-20 토큰입니다. 그 결과 Ethereum에서 가정하던 네 가지 동작이 깨집니다. 컨트랙트로의 호출 없이 컨트랙트의 네이티브 잔액이 변경될 수 있고, `EXTCODEHASH`가 0과 빈 해시 사이를 오갈 수 있으며, 제로 주소로의 전송이 revert되고, 단일 논리적 전송이 소수 잔액 조정으로 인해 여러 개의 `Transfer` 이벤트를 발생시킬 수 있습니다. - [Stable로 브리징하기](/ko/explanation/usdt0-bridging): USDT는 소스 체인에서 어떤 형태를 취하는지에 따라 두 가지 브리지 경로 중 하나를 통해 Stable에 도달합니다. 두 경로 모두 사용자의 Stable 지갑으로 USDT0를 전달합니다. - [결제 및 송금](/ko/explanation/use-case-payments): P2P 결제와 가맹점 정산을, 자금을 이동시키고 거래 비용을 지불하는 하나의 자산을 중심으로 구축했습니다. - [급여 및 대량 지급](/ko/explanation/use-case-payroll): 직원, 계약자, 공급업체에게 대규모로 지급하되, 예측 가능한 처리량, 예측 가능한 비용, 민감한 금액에 대한 프라이버시를 제공합니다. - [비공개 송금](/ko/explanation/use-case-private): 금액이 상업적으로 민감하여 외부에 공개되어서는 안 되는 자금 운용, 공급업체 결제, 급여 지급 등의 작업입니다. - [스폰서 및 가스리스 경험](/ko/explanation/use-case-sponsored): 가스를 사용자 경험에서 완전히 제거하고 싶어하는 앱을 위한 것으로, 처음 사용하는 사용자가 별도의 자산을 먼저 확보하지 않고도 로그인하고 거래할 수 있게 합니다. - [HTTP 엔드포인트 수익화](/ko/explanation/x402): x402는 HTTP 위에 구축된 결제 프로토콜입니다. 서버가 `402 Payment Required`와 결제 세부 정보로 응답하면, 클라이언트가 [ERC-3009](/ko/explanation/erc-3009) 인증을 서명하고, 퍼실리테이터가 이를 온체인에서 정산합니다. 전체 교환 과정은 표준 HTTP 헤더를 통해 이루어집니다. 클라이언트는 지갑만 있으면 됩니다. 회원 가입도, API 키도, 카드 등록도 필요 없습니다. - [Integrate Stable](/en): Stable is a Layer 1 where USDT0 is both the native gas token and an ERC-20. Single-slot finality, sub-second block times, and full EVM compatibility. You bring your wallet, seed phrase, and USDT0. - [Bridge USDT0 to Stable](/en/tutorial/bridge-usdt0): In this tutorial, you will bridge USDT0 from Ethereum Sepolia to the Stable Testnet programmatically using TypeScript and ethers v6. You will build the script incrementally, adding one function per step. - [Quick start](/en/tutorial/quick-start): The only tools you need are Node.js, some USDT0 from the faucet and a private key. Stable uses USDT0 as its gas token, so you only need USDT0 to transact. There is no separate gas asset to fund. - [SDK quickstart](/en/tutorial/sdk-quickstart): You'll install `@stablechain/sdk`, create a client signed by a private key, send a USDT0 transfer on Stable Testnet, and fetch a bridge and swap quote. Total time: about five minutes. - [Send your first USDT0](/en/tutorial/send-usdt0): On Stable, USDT0 is both the chain's native asset and an ERC-20 token. This means `approve`, `transferFrom`, and `permit` remain fully available alongside standard value transfers, and both paths move funds from the same underlying balance. - [Deploy a smart contract](/en/tutorial/smart-contract): In this tutorial, you will deploy a simple smart contract to the Stable Testnet and read its state from the chain. Along the way, you will learn how Stable's network is configured, how USDT0 works as a gas token, and how to point standard EVM tooling at Stable. - [Brand Kit](/en/resources/brand-kit): The Stable brand kit includes logos in multiple formats and the official color palette. Use it to keep Stable's branding consistent across projects and communications. - [Facilitators](/en/reference/agentic-facilitators): A facilitator verifies a signed x402 payment and submits the on-chain call that settles it in USDT0 on Stable. Using a hosted facilitator means you do not run settlement infrastructure or manage gas tokens. For the rail-level context, see [Agent settlement](/en/explanation/agent-settlement). - [Wallets](/en/reference/agentic-wallets): Agent wallets give AI agents and autonomous systems self-custodial signing so they can participate in x402 payment flows without human-driven setup. - [Bank precompile reference](/en/reference/bank-module-api): **Concept:** For what the bank module does and when to use it, see [Bank module](/en/explanation/bank-module). - [Bridges](/en/reference/bridges): Bridge providers supporting USDT0 transfers to and from Stable. For how cross-chain USDT0 movement works, see [Bridging to Stable](/en/explanation/usdt0-bridging). For a hands-on walkthrough, see the [Bridge USDT0 to Stable Testnet](/en/tutorial/bridge-usdt0) tutorial. - [Connect](/en/reference/connect): This page consolidates the network details you need to connect to Stable. - [Custody](/en/reference/custody): **MPC custody infrastructure:** Platforms using multi-party computation to distribute private key control across multiple parties. These provide secure key management, policy engines, and developer APIs for institutional digital asset operations. - [Developer assistance](/en/reference/developer-assistance): A growing collection of developer-focused questions covering topics such as: - [DEXes](/en/reference/dexes): DEX deployments on Stable for spot trading, liquidity provision, and on-chain routing. Stable is on the [Official Uniswap v3 Deployments List](https://gov.uniswap.org/t/official-uniswap-v3-deployments-list/24323/13#p-58106-stable-4): the Uniswap v3 contracts on Stable are governance-recognized as canonical and are routed through [Stable Swap](https://swap.stable.xyz) as the default frontend. - [Distribution precompile reference](/en/reference/distribution-module-api): **Concept:** For what the distribution module does and when to use it, see [Distribution module](/en/explanation/distribution-module). - [EIP-7702](/en/reference/eip-7702-api): Stable supports **EIP-7702**, which allows an EOA to set its account code to an existing smart contract. EOAs keep their original address and private key while executing the delegate's logic. - [FAQ](/en/reference/faq): **What is Stable?** - [Gas pricing reference](/en/reference/gas-pricing-api): Transaction construction, gas estimation, and tooling configuration for Stable. - [Gas waiver protocol](/en/reference/gas-waiver-api): This document specifies the Gas Waiver mechanism: transaction formats, marker routing, governance controls, and the Waiver Server API. - [Indexers](/en/reference/indexers): Indexers and analytics platforms provide structured access to on-chain data, enabling developers to query transactions, balances, logs, events, and application-specific data at scale. Stable is EVM-compatible, so standard Ethereum indexing tools work seamlessly. - [Settle invoices](/en/reference/invoices): Each invoice maps to a unique, deterministic nonce derived from invoice metadata: invoice number, parties, amount, and due date. This nonce drives settlement via [ERC-3009](/en/explanation/erc-3009) and creates an immutable receipt that can be reconciled with existing accounting systems. - [JSON-RPC API](/en/reference/json-rpc-api): [**Gas pricing reference**](/en/reference/gas-pricing-api) — Construct EIP-1559 transactions against Stable's base-fee-only model. - [Mainnet information](/en/reference/mainnet-information): Everything you need to know to access Stable Mainnet. - [Version history](/en/reference/mainnet-version-history): Complete version history and related documentation for the Stable Mainnet. - [Network routing](/en/reference/network-routing): Network routing providers optimizing connectivity and data delivery for applications on Stable. - [Network upgrades](/en/reference/network-upgrades) - [Operate](/en/reference/node-operations-overview): Operate covers running a Stable node: full or archive, testnet or mainnet, from install through monitoring. For the chain-level behavior your node enforces (fee model, finality, USDT0 as gas), see [Gas pricing](/en/explanation/gas-pricing), [Finality](/en/explanation/finality), and the [Architecture overview](/en/explanation/core-optimization-overview). - [Oracles](/en/reference/oracles): Oracles provide smart contracts with off-chain data such as asset prices. RedStone operates price feeds on Stable. - [Send and receive USDT0](/en/reference/p2p-payments): On Stable, P2P payments settle in under a second. Two transfer methods are available depending on the use case. - [Bill per API request](/en/reference/pay-per-call): Monetize any HTTP endpoint with per-request pricing using [x402](/en/explanation/x402) middleware. A server declares its price, a client pays per call, and settlement happens within the request lifecycle. No accounts, no API keys, no billing cycles. - [Ramps](/en/reference/ramps): On/off ramp partners connect Stable to global fiat systems, enabling users and businesses to move between USDT, local currencies, and payment rails. - [RPC providers](/en/reference/rpc-providers): RPC and developer infrastructure providers supporting Stable. - [SDK reference](/en/reference/sdk): Full surface of `@stablechain/sdk`. For a walkthrough, see [SDK quickstart](/en/tutorial/sdk-quickstart). - [Staking precompile reference](/en/reference/staking-module-api): **Concept:** For what the staking module does and when to use it, see [Staking module](/en/explanation/staking-module). - [Set up recurring billing](/en/reference/subscriptions): Pull-based subscriptions let a service provider collect payments on a schedule without requiring the subscriber to initiate each payment. - [System modules reference](/en/reference/system-modules-api-overview): Stable exposes core settlement behavior through **System Modules**, implemented as **precompiled contracts** for gas efficiency and predictable control. - [System transactions reference](/en/reference/system-transactions-api): **Concept:** For how system transactions bridge SDK events to the EVM and why this matters, see [System transactions](/en/explanation/system-transactions). - [Ecosystem](/en/reference/testnet-ecosystem): In this document, you can find the information for bridge (LayerZero) and USDT0. - [Testnet information](/en/reference/testnet-information): Everything you need to know to access the Stable Testnet. - [Version history](/en/reference/testnet-version-history): Complete version history and related documentation for the Stable Testnet. - [Tokenomics](/en/reference/tokenomics): STABLE is the governance token of the Stable Mainnet. It secures the network through delegated Proof-of-Stake, governs protocol upgrades, and entitles stakers to a share of USDT0 gas revenue distributed by validators. - [Wallets](/en/reference/wallets): **User Wallets:** These are traditional consumer-facing wallets such as mobile apps, browser extensions, or exchange-linked wallets. They allow users to hold USDT, make transfers, connect to dApps, and interact directly with Stable. - [Account abstraction with EIP-7702](/en/how-to/account-abstraction): This guide walks through applying EIP-7702 to an EOA and using the delegation for three patterns: batch payments, spending limits, and session keys. The EOA keeps its address and private key throughout. - [Build an MPP endpoint on Stable](/en/how-to/build-mpp-endpoint): This guide walks through writing a custom [MPP](/en/explanation/mpp) payment method for USDT0 on Stable and serving an MPP-gated endpoint. The buyer signs an [ERC-3009](/en/explanation/erc-3009) `transferWithAuthorization`, the server validates it through `mppx`'s `verify()` hook, and settlement happens in a separate step you control. - [Learn P2P payments](/en/how-to/build-p2p-payments): This guide walks through building a P2P payment application on Stable. The app handles the full payment lifecycle: the sender transfers USDT0 directly, the receiver detects the incoming payment in real time, and both can query their own transaction history. Same architecture as any wallet or payment interface, whether a mobile app, web checkout, or backend service. - [Build a pay-per-call API](/en/how-to/build-pay-per-call): This guide walks through monetizing an API endpoint with x402. The server adds a payment handler, the client pays per request, and settlement happens within the HTTP lifecycle. - [Create a wallet](/en/how-to/create-wallet): A Stable wallet is an Ethereum-standard key pair. Any wallet library that produces an EVM account works on Stable without modification. This guide shows two paths: ethers.js for most applications, and Tether's [WDK (Wallet Development Kit)](https://github.com/tetherto/wdk) for integrations that want a turnkey self-custody layer for agents and payments. - [Index contract events](/en/how-to/index-contract): Indexing turns on-chain events into data your application can react to: balance updates, transaction history, UI notifications. This guide shows how to subscribe to events from a deployed Stable contract using ethers.js and how to backfill historical events so you don't miss any emitted while your service was offline. - [Index validator data](/en/how-to/index-validator-data): Validator data lives on-chain and is readable over standard EVM JSON-RPC. You query current state through the staking, slashing, and governance precompiles, and you reconstruct history from their event logs. This means an indexer or analytics platform reads everything it needs through `eth_call` and `eth_getLogs`, with no access to a node's `stabled` CLI or Cosmos REST. - [Enable gas-free transactions](/en/how-to/integrate-gas-waiver): Gas Waiver enables gas-free transactions on Stable. With Gas Waiver, applications cover gas fees on behalf of users, so users can interact with contracts without holding USDT0 for gas. - [Paying with invoice](/en/how-to/pay-with-invoice): This guide walks through settling an invoice on-chain using [ERC-3009](/en/explanation/erc-3009) with a deterministic nonce derived from invoice metadata. The nonce links each payment to its invoice and prevents double payment. - [Paying with MCP server](/en/how-to/pay-with-mcp): This guide shows how to bridge x402-enabled APIs to [MCP](https://modelcontextprotocol.io) tools so AI clients can call and pay for them through natural-language prompts. It builds on the server from [Build a pay-per-call API](/en/how-to/build-pay-per-call). - [Production readiness](/en/how-to/production-readiness): Work through each section below before switching from testnet to mainnet. - [Use the SDK with viem](/en/how-to/sdk-with-viem): `@stablechain/sdk` is built on viem. `createStable` accepts three signing modes, and you pick one based on where the code runs: server-side with a private key, browser-side with the user's wallet, or with a `WalletClient` you've already constructed (for example, in a wagmi app). - [Use the SDK with wagmi](/en/how-to/sdk-with-wagmi): `createStable` accepts a viem `WalletClient`, which is exactly what wagmi's `useWalletClient` returns. You connect the wallet through wagmi as you normally would, then memoize a `StableClient` whenever the wallet client changes. - [Self-hosted gas waiver](/en/how-to/self-hosted-gas-waiver): Self-hosted Gas Waiver lets you operate your own waiver infrastructure instead of using the hosted Waiver Server API. You register a waiver address through on-chain governance, then broadcast wrapper transactions directly to the network. - [Subscribe and collect](/en/how-to/subscribe-and-collect): This guide walks through building a subscription payment system where the subscriber authorizes once and the service provider collects each billing cycle automatically via EIP-7702 account abstraction. - [Tracking unbonding completions](/en/how-to/track-unbonding): When an unbonding period completes, the protocol emits an `UnbondingCompleted` event through the `StableSystem` precompile (`0x0000000000000000000000000000000000009999`) via a system transaction. This lets dApps notify users and update balances in real time without running custom indexers or polling REST endpoints. - [Get testnet USDT0](/en/how-to/use-faucet): Stable uses USDT0 as the gas token, so you need USDT0 in your wallet to submit transactions. There are two ways to fund a testnet wallet: the faucet for small amounts, or bridging from Ethereum Sepolia for larger amounts. - [Use system modules](/en/how-to/use-system-modules): Stable exposes protocol-level settlement logic through **precompiled contracts** at fixed addresses. The precompiles let EVM code call Stable SDK modules (staking, reward distribution, STABLE token operations) without re-implementing them. They're significantly more gas efficient than equivalent Solidity implementations because they run at the protocol level. - [Verify a smart contract](/en/how-to/verify-contract): Verification uploads your contract's source code to the block explorer and proves it compiles to the deployed bytecode. Once verified, users can read state, call functions, and audit the source on Stablescan without re-hosting your code. This guide walks through verifying a Foundry-deployed contract on Stable. - [Work with USDT0 as gas](/en/how-to/work-with-usdt-gas): On Stable, USDT0 is both the chain's native asset and an ERC-20 token. The gas token is USDT0, not a separate native asset. Standard Ethereum gas estimation works once you adjust three things: `maxPriorityFeePerGas` is always `0`, `baseFee` is denominated in USDT0, and the `value` field in a native transfer carries USDT0 (not ETH). - [Zero gas transactions](/en/how-to/zero-gas-transactions): Gas Waiver lets an application cover gas on behalf of a user. The user signs a transaction with `gasPrice = 0`, a governance-registered waiver wraps it, and validators execute the call at zero cost to the user. This guide walks through a qualifying transfer, shows how to verify gas was waived, and explains what the waiver does and doesn't cover. - [Accounts guides](/en/explanation/accounts-guides): Every guide, concept, and reference under the Accounts tab, grouped by what you're trying to do. - [Accounts on Stable](/en/explanation/accounts-overview): An account on Stable is a standard Ethereum EOA that can optionally execute smart contract logic through [EIP-7702 delegation](/en/explanation/eip-7702). Users keep one address and one private key across wallets, batch payments, recurring subscriptions, and session keys. Agents run the same account model without any custodial middleware. - [Agent settlement](/en/explanation/agent-settlement): Agent settlement is Stable's rail for machine payments. An agent holds a USDT0 balance, pays for a resource over HTTP, and the payment settles on-chain in the same request cycle. The agent spends down from one balance for both the payment and the network fee. There is no separate gas token, no sign-up, and no API key rotation. - [AI and agents guides](/en/explanation/ai-agents-guides): Every guide, concept, and reference under the AI/Agents tab, grouped by what you're trying to do. - [Autobahn](/en/explanation/autobahn): Modern Byzantine Fault Tolerant (BFT) consensus protocols typically operate under the partial synchrony model. This model assumes that the network eventually stabilizes and message delays remain bounded. While practical for protocol design, real-world deployments rarely enjoy long periods of uninterrupted stability. Instead, systems frequently experience periods of synchrony followed by short disruptions such as latency spikes, node outages, or adversarial conditions. These transient disruptions are referred to as **“blips”**. - [Bank module](/en/explanation/bank-module): The `x/bank` module in Stable's SDK handles token balances, transfers, and supply. Its EVM surface (the **bank precompile**) wraps this module and adds ERC-20 semantics plus an authorization layer for privileged mint/burn operations. Contracts that need to move tokens on Stable call the precompile directly without deploying their own token implementation. - [Bridge security and DVNs](/en/explanation/bridge-security): A LayerZero bridge is only as secure as the verification layer that confirms a message sent on one chain happened on another. That layer is a Decentralized Verifier Network (DVN). This page explains what DVNs do, how Stable configures them on its bridges, and why a compromise of any single DVN does not put Stable at risk. - [Overview](/en/explanation/build-overview): New to Stable? Run the [Quick start](/en/tutorial/quick-start) first. It takes five minutes and sends a testnet transaction so the rest of the tab has something to plug into. - [Confidential transfer](/en/explanation/confidential-transfer): **Confidential Transfer** is a privacy layer on Stable that shields the **amount** of a USDT0 transfer while keeping sender and recipient addresses publicly visible. The shielded amount is readable only by the transacting parties and authorized regulatory auditors, using zero-knowledge (ZK) cryptography to prove validity without revealing the value. The feature is under development; this page describes the target model. - [Consensus](/en/explanation/consensus): Stable Blockchain leverages **StableBFT**, a customized PoS consensus protocol built on CometBFT, to deliver high throughput, low latency, and strong reliability. StableBFT provides deterministic finality (blocks are final on inclusion, without forks) and Byzantine fault tolerance up to 1/3 of validators failing or acting maliciously. - [Contracts guides](/en/explanation/contracts-guides): Every guide, concept, and reference under the Contracts tab, grouped by what you're trying to do. - [Contracts on Stable](/en/explanation/contracts-overview): Stable is fully EVM-compatible. Solidity, Vyper, Hardhat, Foundry, ethers.js, and viem work unchanged. Existing contracts deploy as-is once you point tooling at Stable's RPC. On top of the standard EVM, Stable exposes protocol-level modules (Bank, Distribution, Staking) as precompiled contracts at fixed addresses, so your Solidity can call into staking and reward distribution without re-implementing them. - [Core concepts](/en/explanation/core-concepts): Four concepts are enough to start building. Each section defines the concept, shows it, and links to the full reference. - [Overview](/en/explanation/core-optimization-overview): The lifecycle of a blockchain transaction, from submission to finalized result, passes through multiple tightly connected stages. A transaction is first submitted through the **RPC** interface, added to the **mempool**, packaged into a block, validated through **consensus**, executed by the **state machine**, and finally written to persistent storage in the **database**. Only after completing this full pipeline does the user receive a confirmed result. - [Distribution module](/en/explanation/distribution-module): The `x/distribution` module handles staking-reward accrual and withdrawal for delegators and validators. Its precompile bridges this behavior into the EVM so a Solidity contract can claim rewards, set withdraw addresses, and query outstanding rewards without interacting with the Cosmos SDK directly. - [EIP-7702](/en/explanation/eip-7702): Stable supports **EIP-7702**, which allows an EOA to **set its account code to an existing smart contract**. The EOA executes that contract's logic while keeping its original address and private key. The delegation is persistent until the EOA explicitly changes or clears it. - [Settle with signed authorizations](/en/explanation/erc-3009): ERC-3009 lets a token holder authorize a transfer by signing a message. Anyone can then submit that signed authorization to execute the transfer on-chain. The sender never needs to call the contract directly. - [Ethereum comparison](/en/explanation/ethereum-comparison): Stable is fully EVM-compatible, so most Ethereum tools, libraries, and contract patterns work without modification. The sections below walk through what stays the same and what changes when you move from Ethereum to Stable. - [Compatibility with the Ethereum ecosystem](/en/explanation/ethereum-compatibility): Stable is fully compatible with the Ethereum Virtual Machine (EVM), allowing developers to use familiar tools, libraries, and contract patterns without modification. This ensures seamless migration of existing applications and straightforward onboarding for teams already building in the Ethereum ecosystem. - [Execution](/en/explanation/execution): **Stable EVM** is Stable's Ethereum-compatible execution layer. Existing Ethereum tools and wallets like MetaMask interact with Stable unchanged. Stable EVM combines the EVM's developer experience with the modular infrastructure of the Stable SDK. - [Finality rules & compatibility guarantees](/en/explanation/finality): Stable processes transactions within an EVM-based execution environment. When a block includes a transaction, the chain applies its effects to state and makes them immediately visible to applications, contracts, and indexers. - [Flow of Funds](/en/explanation/flow-of-funds): Stable is the first blockchain purpose-built for stablecoin payments. The network is optimized for high-throughput, low-latency stablecoin transactions, delivering P2P payments and merchant acceptance with immediate settlement in USDT. Application-layer gas sponsorship and waivers allow providers to offer a zero-fee experience for end users, providing the feel of a mainstream payments network while abstracting away the complexity of blockchain systems. - [Gas pricing](/en/explanation/gas-pricing): Stable uses a simplified, single-component gas fee model designed to remove fee volatility and deliver predictable, low transaction costs. Transaction ordering is not influenced by tip bidding. The effective gas price is determined solely by the protocol's base fee. - [Gas waiver](/en/explanation/gas-waiver): Governance-approved addresses (called **waivers**) submit a wrapper transaction that carries the user's signed payload and executes it at `gasPrice = 0`. The user holds no USDT0 and pays no gas. Stable operates one such waiver as a hosted service; partners can also register their own waiver addresses through validator governance. - [Guaranteed blockspace](/en/explanation/guaranteed-blockspace): **Guaranteed Blockspace** is a dedicated blockspace-allocation model that reserves a fixed share of every block's capacity for enrolled enterprise partners, regardless of broader network conditions. Transactions routed through the guaranteed path execute with predictable latency and cost. Payroll, settlement, and supplier payments don't compete with public mempool traffic. - [High performance RPC](/en/explanation/high-performance-rpc): In the pursuit of a high-performance blockchain, it's not enough to only optimize consensus or block production. The RPC layer is a critical component of the end-to-end user experience because it is the interface between the blockchain and its users. Stable proposes a new RPC-dedicated architecture to overcome the limitations of traditional RPC design. - [Overview](/en/explanation/integrate-overview): Stable is an EVM-compatible Layer 1 where USDT0 is the native gas token. Most Ethereum tools, libraries, and contract patterns work without modification. You connect by pointing your RPC to Stable and switching the chain ID. - [Key features](/en/explanation/key-features): Stable is a delegated Proof-of-Stake Layer 1 with single-slot finality, full EVM compatibility, and USDT0 as the native gas token. The features below are the ones that shape day-to-day integration. Each links to the page that covers it in depth. - [Learn](/en/explanation/learn-overview): [**Overview**](/en/explanation/overview) — What Stable is and how to read this documentation. - [MPP sessions](/en/explanation/mpp-sessions): A session is an MPP payment intent that batches many small payments into a single on-chain settlement. The client deposits funds into an escrow once, then signs cheap off-chain vouchers for each request. Only the net amount settles on-chain, which makes sub-cent per-request economics viable for streaming workloads. - [Machine Payments Protocol (MPP)](/en/explanation/mpp): MPP (Machine Payments Protocol) is an open standard for paying for HTTP resources in the same request that asks for them. It extends [x402](/en/explanation/x402) with new payment intents (charge, subscription, session), multi-rail support (stablecoins, cards, Lightning), production features (idempotency, body-digest binding, expiration), and additional transports (MCP, WebSocket). The protocol is on the IETF standards track. - [Overview](/en/explanation/overview): Stable is a Layer 1 where USDT0 is the native gas token, and standard EVM tooling (Solidity, Foundry, Hardhat, ethers, viem, and the `eth_*` JSON-RPC methods) works unchanged. - [Use cases overview](/en/explanation/payment-use-cases-overview): Stable supports multiple payment patterns, from simple wallet-to-wallet transfers to agent-driven service payments. The use cases below cover the patterns that are production-ready today. For patterns on the horizon (guaranteed settlement, confidential payments, agent-to-agent commerce), see [Upcoming use cases](/en/explanation/upcoming-use-cases). - [Payments guides](/en/explanation/payments-guides): Every guide, concept, and reference under the Payments tab, grouped by what you're trying to do. - [Payments on Stable](/en/explanation/payments-overview): Stable is built around payments. USDT0 is the native asset and the gas token, so settlement and fees share one balance. Single-slot finality means a transfer clears in under a second. ERC-3009, EIP-7702, and x402 are native primitives, not workarounds — you can settle with a signature, pull from a delegated account, or charge per HTTP request without running a billing stack. - [Stable SDK](/en/explanation/sdk-overview): `@stablechain/sdk` is the official TypeScript client for Stable. It wraps viem with a small, typed API for the operations you reach for most: transfer USDT0, bridge between chains, and swap tokens on Stable. Routing, approvals, decimals, and chain switching are handled for you. - [Storage (StableDB)](/en/explanation/stable-db): One of the main bottlenecks in end-to-end blockchain performance is **Disk I/O**. Specifically, committing and storing state data after block execution creates the key bottleneck. Stable tackles this problem with architectural innovations such as `MemDB`, `VersionDB`, and memory-mapped storage (`mmap`) to dramatically improve throughput. - [Staking module](/en/explanation/staking-module): The `x/staking` module controls validator participation and delegation on Stable. Its precompile makes these operations callable from Solidity, so a contract can delegate STABLE, undelegate after the unbonding period, redelegate between validators, or query validator state without leaving the EVM. - [System modules](/en/explanation/system-modules-overview): Stable's core protocol behavior lives in SDK modules: `x/bank`, `x/distribution`, `x/staking`. To make this behavior accessible from the EVM, Stable exposes each module as a **precompiled contract** at a fixed address. Contracts written in Solidity call the precompile directly, and the EVM routes the call into the native SDK handler. Precompiles are implemented at the protocol level, making them significantly more gas-efficient than an equivalent Solidity re-implementation. - [System transactions](/en/explanation/system-transactions): EVM applications subscribe to on-chain activity through standard interfaces like `eth_getLogs`. But some of the most important operations on Stable (staking unbonding completions, for example) happen inside SDK modules that don't naturally emit EVM events. **System transactions** close this visibility gap: the protocol itself submits EVM transactions that emit events for SDK-layer operations, making them indexable through the same log stream dApps already use. - [Tech overview](/en/explanation/tech-overview): **What's live today:** StableBFT consensus, Stable EVM (full EVM compatibility), and the split-path RPC layer are all production-ready. StableDB ships in the v1.4.0 upgrade. Autobahn (DAG-based consensus) and StableVM++ (optimistic parallel execution) are roadmap items. See the [Roadmap](/en/explanation/technical-roadmap) for timelines. - [Roadmap](/en/explanation/technical-roadmap): Stable optimizes every layer of the transaction pipeline (consensus, execution, storage, RPC, and USDT-specific flows) across three phases. This page marks what's shipped, what's in progress, and what's still ahead. - [Upcoming use cases](/en/explanation/upcoming-use-cases): Stable is building toward payment patterns that go beyond simple transfers and API billing. The cases below cover time-guaranteed settlement, privacy-preserving payments, and autonomous agent commerce. Some are functional today in early form; others depend on Stable features currently in development. - [USDT as gas](/en/explanation/usdt-as-gas-token): **You pay fees in USDT0. No second token, no wrapping, no ETH-equivalent to keep topped up.** USDT0 serves as both the native gas token and an ERC-20 token on the same balance. The same asset that moves as payment also pays for the transaction that moves it. Fees are denominated in dollars, not a volatile native token. - [Overview](/en/explanation/usdt-features-overview): Stable's USDT-specific features aren't a menu of independent options. They compose. Each one removes a specific friction that shows up when stablecoin payments move from demos to production. This page explains why the five features exist together. - [USDT transfer aggregator](/en/explanation/usdt-transfer-aggregator): The **USDT Transfer Aggregator** bundles USDT0 transfers into parallelized, fault-tolerant batches instead of processing each transfer sequentially. It isolates USDT0 throughput from the rest of the execution pipeline so high-volume stablecoin activity doesn't crowd out other transactions. - [USDT0 behavior on Stable](/en/explanation/usdt0-behavior): **If you're porting a contract from Ethereum, read this page before deploying.** USDT0 on Stable is both the native gas token and an ERC-20 token on the same balance. Four Ethereum-assumed behaviors break as a result: a contract's native balance can change without a call into the contract, `EXTCODEHASH` can oscillate between zero and empty hash, zero-address transfers revert, and a single logical transfer can emit multiple `Transfer` events from fractional-balance reconciliation. - [Bridging to Stable](/en/explanation/usdt0-bridging): USDT reaches Stable via one of two bridge paths, depending on what form it takes on the source chain. Both paths deliver USDT0 into the user's wallet on Stable. - [Payments & transfers](/en/explanation/use-case-payments): P2P payments and merchant settlement built around one asset that moves the money and pays for the transaction. - [Payroll & mass payouts](/en/explanation/use-case-payroll): Paying employees, contractors, and suppliers at scale, with predictable throughput, predictable cost, and privacy for sensitive amounts. - [Private transfers](/en/explanation/use-case-private): Treasury operations, supplier payments, and salary runs where the amount is commercially sensitive and shouldn't be published to the world. - [Sponsored and gasless experiences](/en/explanation/use-case-sponsored): Apps that want to remove gas from the user experience entirely, so a first-time user can sign in and transact without acquiring a second asset first. - [Monetize HTTP endpoints](/en/explanation/x402): x402 is a payment protocol built on HTTP. A server responds with `402 Payment Required` and payment details, a client signs an [ERC-3009](/en/explanation/erc-3009) authorization, and a facilitator settles it on-chain. The entire exchange happens over standard HTTP headers. The client only needs a wallet: no sign-up, no API keys, no card registration. - [集成 Stable](/cn): Stable 是一个 Layer 1,其中 USDT0 既是原生 gas 代币,也是一种 ERC-20。单槽最终性、亚秒级出块时间,以及完整的 EVM 兼容性。你只需带上你的钱包、助记词和 USDT0。 - [将 USDT0 跨链桥接到 Stable](/cn/tutorial/bridge-usdt0): 在本教程中,你将使用 TypeScript 和 ethers v6 以编程方式将 USDT0 从 Ethereum Sepolia 桥接到 Stable Testnet。你将逐步构建这个脚本,每一步添加一个函数。 - [快速开始](/cn/tutorial/quick-start): 你只需要 Node.js、一些来自水龙头的 USDT0 以及一个私钥。Stable 使用 USDT0 作为其 gas 代币,因此你只需要 USDT0 即可进行交易。无需单独为某种 gas 资产注资。 - [SDK 快速开始](/cn/tutorial/sdk-quickstart): 你将安装 `@stablechain/sdk`,创建一个由私钥签名的客户端,在 Stable Testnet 上发送一笔 USDT0 转账,并获取跨链桥和兑换报价。总耗时约五分钟。 - [发送你的第一笔 USDT0](/cn/tutorial/send-usdt0): 在 Stable 上,USDT0 既是链的原生资产,也是一个 ERC-20 代币。这意味着 `approve`、`transferFrom` 和 `permit` 在标准价值转账之外仍然完全可用,并且这两条路径都从同一个底层余额中转移资金。 - [部署智能合约](/cn/tutorial/smart-contract): 在本教程中,你将向 Stable 测试网部署一个简单的智能合约,并从链上读取其状态。在此过程中,你将了解 Stable 网络的配置方式、USDT0 如何作为 gas 代币运作,以及如何将标准 EVM 工具指向 Stable。 - [Brand Kit](/cn/resources/brand-kit): 您可以在下方找到 Stable 的Brand Kit,其中包含标志的多种格式版本和配色方案。本工具包旨在帮助您在项目或传播中使用 Stable 品牌时保持一致性。 - [结算服务商(Facilitators)](/cn/reference/agentic-facilitators): 结算服务商(facilitator)负责验证已签名的 x402 支付,并提交在 Stable 上以 USDT0 结算的链上调用。使用托管的结算服务商意味着你无需运行结算基础设施或管理 gas 代币。如需了解通道层面的背景信息,请参阅 [代理结算](/cn/explanation/agent-settlement)。 - [钱包](/cn/reference/agentic-wallets): 代理钱包为 AI 代理和自主系统提供自托管签名能力,使它们能够参与 x402 支付流程,而无需人工驱动的设置。 - [Bank 预编译合约参考](/cn/reference/bank-module-api): **概念:** 关于 bank 模块的功能及其使用场景,请参阅 [Bank 模块](/cn/explanation/bank-module)。 - [跨链桥](/cn/reference/bridges): 支持在 Stable 之间转移 USDT0 的跨链桥提供商。关于跨链 USDT0 转移的工作原理,请参阅[跨链转入 Stable](/cn/explanation/usdt0-bridging)。如需实操演练,请参阅[将 USDT0 跨链转入 Stable 测试网](/cn/tutorial/bridge-usdt0)教程。 - [连接](/cn/reference/connect): 本页整合了连接到 Stable 所需的网络详细信息。 - [托管](/cn/reference/custody): **MPC 托管基础设施:** 使用多方计算将私钥控制权分散到多方的平台。它们为机构数字资产运营提供安全的密钥管理、策略引擎和开发者 API。 - [开发者支持](/cn/reference/developer-assistance): 如何连接 Stable 网络? - [DEX(去中心化交易所)](/cn/reference/dexes): Stable 上的 DEX 部署,用于现货交易、流动性提供和链上路由。Stable 已列入[官方 Uniswap v3 部署列表](https://gov.uniswap.org/t/official-uniswap-v3-deployments-list/24323/13#p-58106-stable-4):Stable 上的 Uniswap v3 合约经治理认可为规范部署,并通过 [Stable Swap](https://swap.stable.xyz) 作为默认前端进行路由。 - [Distribution 预编译参考](/cn/reference/distribution-module-api): **概念:** 关于 distribution 模块的功能以及何时使用它,请参阅 [Distribution 模块](/cn/explanation/distribution-module)。 - [EIP-7702](/cn/reference/eip-7702-api): Stable 支持 **EIP-7702**,它允许 EOA 将其账户代码设置为现有的智能合约。EOA 在执行委托方逻辑的同时保留其原始地址和私钥。 - [常见问题](/cn/reference/faq): **什么是 Stable?** - [Gas 定价参考](/cn/reference/gas-pricing-api): Stable 上的交易构建、gas 估算和工具链配置。 - [Gas 豁免协议](/cn/reference/gas-waiver-api): 本文档规定了 Gas 豁免机制:交易格式、标记路由、治理控制以及 Waiver Server API。 - [索引器](/cn/reference/indexers): 索引器和分析平台提供对链上数据的结构化访问,使开发者能够大规模查询交易、余额、日志、事件以及应用特定数据。Stable 兼容 EVM,因此标准的以太坊索引工具可无缝运行。 - [结算发票](/cn/reference/invoices): 每张发票都映射到一个唯一的、确定性的 nonce,该 nonce 派生自发票元数据:发票编号、交易方、金额和到期日。此 nonce 通过 [ERC-3009](/cn/explanation/erc-3009) 驱动结算,并创建一个不可变的收据,可与现有会计系统进行对账。 - [JSON-RPC API](/cn/reference/json-rpc-api) - [主网信息](/cn/reference/mainnet-information): 访问 Stable 主网所需的全部信息。 - [版本历史](/cn/reference/mainnet-version-history): Stable 主网的完整版本历史及相关文档。 - [网络路由](/cn/reference/network-routing): 为 Stable 上的应用优化连接性和数据传输的网络路由提供商。 - [网络升级](/cn/reference/network-upgrades) - [运维](/cn/reference/node-operations-overview): 运维涵盖运行 Stable 节点的方方面面:全节点或归档节点、测试网或主网,从安装到监控。关于您的节点所强制执行的链级行为(费用模型、最终性、USDT0 作为 gas),请参阅 [Gas 定价](/cn/explanation/gas-pricing)、[最终性](/cn/explanation/finality) 和 [架构概览](/cn/explanation/core-optimization-overview)。 - [预言机](/cn/reference/oracles): 预言机为智能合约提供链下数据,例如资产价格。RedStone 在 Stable 上运营价格喂送。 - [发送和接收 USDT0](/cn/reference/p2p-payments): 在 Stable 上,P2P 支付在不到一秒内完成结算。根据使用场景,有两种转账方式可供选择。 - [按 API 请求计费](/cn/reference/pay-per-call): 使用 [x402](/cn/explanation/x402) 中间件,通过每次请求的定价来实现任何 HTTP 端点的货币化。服务器声明价格,客户端按调用付费,结算在请求生命周期内完成。无需账户、无需 API 密钥、无需计费周期。 - [出入金通道](/cn/reference/ramps): 出入金通道合作伙伴将 Stable 连接到全球法定货币系统,使用户和企业能够在 USDT、本地货币和支付通道之间进行转移。 - [RPC 提供商](/cn/reference/rpc-providers): 支持 Stable 的 RPC 和开发者基础设施提供商。 - [SDK 参考](/cn/reference/sdk): `@stablechain/sdk` 的完整功能。如需操作指南,请参阅 [SDK 快速开始](/cn/tutorial/sdk-quickstart)。 - [质押预编译合约参考](/cn/reference/staking-module-api): **概念:** 关于质押模块的功能及使用场景,请参阅 [质押模块](/cn/explanation/staking-module)。 - [设置定期账单](/cn/reference/subscriptions): 基于拉取的订阅让服务提供商可以按计划收取付款,而无需订阅者主动发起每一笔付款。 - [系统模块参考](/cn/reference/system-modules-api-overview): Stable 通过 **系统模块(System Modules)** 暴露核心结算行为,这些模块以 **预编译合约(precompiled contracts)** 的形式实现,以提升 gas 效率并提供可预测的控制。 - [系统交易参考](/cn/reference/system-transactions-api): **概念:** 关于系统交易如何将 SDK 事件桥接到 EVM 以及为什么这很重要,请参阅[系统交易](/cn/explanation/system-transactions)。 - [生态系统](/cn/reference/testnet-ecosystem): 在本文档中,您可以找到桥接(LayerZero)和 USDT0 的信息。 - [测试网信息](/cn/reference/testnet-information): 访问 Stable 测试网所需了解的一切信息。 - [版本历史](/cn/reference/testnet-version-history): Stable 测试网的完整版本历史及相关文档。 - [代币经济学](/cn/reference/tokenomics): Stable 是一个高性能的第一层区块链,专为稳定币结算、企业级支付和以 USDT 为中心的基础设施而优化。 - [钱包](/cn/reference/wallets): **用户钱包:** 这些是面向消费者的传统钱包,例如移动应用、浏览器扩展或与交易所关联的钱包。它们允许用户持有 USDT、进行转账、连接 dApp,并直接与 Stable 交互。 - [使用 EIP-7702 实现账户抽象](/cn/how-to/account-abstraction): 本指南将逐步介绍如何将 EIP-7702 应用于 EOA,并利用委托实现三种模式:批量支付、支出限额和会话密钥。整个过程中,EOA 始终保持其地址和私钥不变。 - [在 Stable 上构建 MPP 端点](/cn/how-to/build-mpp-endpoint): 本指南将逐步介绍如何为 Stable 上的 USDT0 编写自定义 [MPP](/cn/explanation/mpp) 支付方法,并提供一个受 MPP 保护的端点。买方签署一个 [ERC-3009](/cn/explanation/erc-3009) `transferWithAuthorization`,服务器通过 `mppx` 的 `verify()` 钩子对其进行验证,结算则在你控制的单独步骤中完成。 - [学习 P2P 支付](/cn/how-to/build-p2p-payments): 本指南将带你在 Stable 上构建一个 P2P 支付应用。该应用处理完整的支付生命周期:发送方直接转账 USDT0,接收方实时检测到入账支付,双方都可以查询各自的交易历史。无论是移动应用、网页结账,还是后端服务,任何钱包或支付界面的架构都与此相同。 - [构建按调用付费的 API](/cn/how-to/build-pay-per-call): 本指南介绍如何使用 x402 将 API 端点货币化。服务端添加支付处理逻辑,客户端按请求付费,结算在 HTTP 生命周期内完成。 - [创建钱包](/cn/how-to/create-wallet): Stable 钱包是一个符合以太坊标准的密钥对。任何能生成 EVM 账户的钱包库都可以在 Stable 上直接使用,无需修改。本指南展示两种方式:适用于大多数应用的 ethers.js,以及面向需要为代理和支付提供开箱即用自托管层的集成场景的 Tether [WDK(钱包开发工具包)](https://github.com/tetherto/wdk)。 - [索引合约事件](/cn/how-to/index-contract): 索引将链上事件转化为应用程序可以响应的数据:余额更新、交易历史、UI 通知。本指南展示如何使用 ethers.js 订阅已部署的 Stable 合约的事件,以及如何回填历史事件,这样你就不会遗漏服务离线期间发出的任何事件。 - [索引验证者数据](/cn/how-to/index-validator-data): 验证者数据存储在链上,可通过标准 EVM JSON-RPC 读取。你通过 staking、slashing 和 governance 预编译合约查询当前状态,并从它们的事件日志重建历史。这意味着索引器或分析平台可以通过 `eth_call` 和 `eth_getLogs` 读取所需的一切,无需访问节点的 `stabled` CLI 或 Cosmos REST。 - [启用免 Gas 交易](/cn/how-to/integrate-gas-waiver): Gas Waiver 可在 Stable 上实现免 Gas 交易。借助 Gas Waiver,应用程序代表用户支付 Gas 费用,因此用户无需持有 USDT0 即可与合约进行交互。 - [使用发票付款](/cn/how-to/pay-with-invoice): 本指南演示如何使用 [ERC-3009](/cn/explanation/erc-3009) 在链上结算发票,其中 nonce 由发票元数据确定性派生。该 nonce 将每笔付款与其发票关联起来,并防止重复付款。 - [通过 MCP 服务器付款](/cn/how-to/pay-with-mcp): 本指南展示如何将启用 x402 的 API 桥接到 [MCP](https://modelcontextprotocol.io) 工具,使 AI 客户端能够通过自然语言提示词调用并为其付费。它基于 [构建按调用付费 API](/cn/how-to/build-pay-per-call) 中的服务器构建。 - [生产环境就绪](/cn/how-to/production-readiness): 在从测试网切换到主网之前,请逐一完成下面的每个部分。 - [搭配 viem 使用 SDK](/cn/how-to/sdk-with-viem): `@stablechain/sdk` 基于 viem 构建。`createStable` 接受三种签名模式,你可以根据代码运行的位置选择其一:服务端使用私钥、浏览器端使用用户钱包,或使用你已经构建好的 `WalletClient`(例如在 wagmi 应用中)。 - [在 wagmi 中使用 SDK](/cn/how-to/sdk-with-wagmi): `createStable` 接受一个 viem `WalletClient`,而这正是 wagmi 的 `useWalletClient` 所返回的内容。你像往常一样通过 wagmi 连接钱包,然后在钱包客户端发生变化时记忆化一个 `StableClient`。 - [自托管 gas 豁免](/cn/how-to/self-hosted-gas-waiver): 自托管 Gas 豁免让你可以运营自己的豁免基础设施,而不必使用托管的 Waiver Server API。你通过链上治理注册一个豁免地址,然后直接向网络广播包装交易。 - [订阅与收款](/cn/how-to/subscribe-and-collect): 本指南将引导你构建一个订阅支付系统,订阅者只需授权一次,服务提供方便可在每个计费周期通过 EIP-7702 账户抽象自动收款。 - [追踪解绑完成](/cn/how-to/track-unbonding): 当解绑周期完成时,协议会通过系统交易,借助 `StableSystem` 预编译合约(`0x0000000000000000000000000000000000009999`)发出 `UnbondingCompleted` 事件。这使得 dApp 能够实时通知用户并更新余额,而无需运行自定义索引器或轮询 REST 端点。 - [如何为您的 Stable 测试网钱包充值](/cn/how-to/use-faucet): Stable 使用 USDT0作为燃料代币,因此您需要在钱包中有 USDT0 才能与链进行交互。首先,您需要使用水龙头为您的账户充值 USDT0。 - [使用系统模块](/cn/how-to/use-system-modules): Stable 通过位于固定地址的\*\*预编译合约(precompiled contracts)\*\*暴露协议层的结算逻辑。这些预编译合约让 EVM 代码可以调用 Stable SDK 模块(质押、奖励分发、STABLE 代币操作),而无需重新实现它们。由于它们运行在协议层,因此比等价的 Solidity 实现显著更省 gas。 - [验证智能合约](/cn/how-to/verify-contract): 验证会将合约的源代码上传到区块浏览器,并证明它编译后与已部署的字节码一致。一旦完成验证,用户就可以在 Stablescan 上读取状态、调用函数并审计源代码,而无需重新托管你的代码。本指南将带你完成在 Stable 上验证由 Foundry 部署的合约。 - [将 USDT0 作为 gas 使用](/cn/how-to/work-with-usdt-gas): 在 Stable 上,USDT0 既是链的原生资产,也是一种 ERC-20 代币。gas 代币是 USDT0,而不是单独的原生资产。只要调整三件事,标准的以太坊 gas 估算就能正常工作:`maxPriorityFeePerGas` 始终为 `0`、`baseFee` 以 USDT0 计价,以及原生转账中的 `value` 字段携带的是 USDT0(而非 ETH)。 - [零 gas 交易](/cn/how-to/zero-gas-transactions): Gas Waiver 让应用程序可以代表用户承担 gas 费用。用户使用 `gasPrice = 0` 签署一笔交易,由治理注册的 waiver 将其包装,验证者以零成本为用户执行该调用。本指南将带你完成一笔符合条件的转账,展示如何验证 gas 已被豁免,并解释 waiver 涵盖与不涵盖的范围。 - [账户指南](/cn/explanation/accounts-guides): 账户标签下的每个指南、概念和参考,按你想要完成的任务进行分组。 - [Stable 上的账户](/cn/explanation/accounts-overview): Stable 上的账户是标准的以太坊 EOA,可以通过 [EIP-7702 委托](/cn/explanation/eip-7702)选择性地执行智能合约逻辑。用户在钱包、批量支付、定期订阅和会话密钥中始终保持一个地址和一个私钥。代理使用相同的账户模型运行,无需任何托管中间件。 - [代理结算](/cn/explanation/agent-settlement): 代理结算是 Stable 面向机器支付的通道。代理持有 USDT0 余额,通过 HTTP 为某个资源付费,付款在同一请求周期内于链上结算。代理从同一个余额中同时支出付款和网络费用。无需独立的 gas 代币,无需注册,也无需轮换 API 密钥。 - [AI 与智能体指南](/cn/explanation/ai-agents-guides): AI/智能体标签页下的所有指南、概念和参考,按你想要完成的任务分组。 - [Autobahn](/cn/explanation/autobahn): 现代拜占庭容错(BFT)共识协议通常运行在部分同步模型下,该模型假设在某个不确定的时间点后,网络最终会变得稳定,消息传递延迟会有上限。虽然这个模型在协议设计上是实用的,但现实部署中很少能享受长时间的持续稳定。相反,系统经常经历同步阶段后出现短暂中断,如延迟激增、节点宕机或恶意攻击。这些短暂中断被称为 **“突变(blips)”**。 - [银行模块](/cn/explanation/bank-module): Stable SDK 中的 `x/bank` 模块仅提供基本的代币管理功能。 每个代币都可以无限制地转移到任何账户,用户无法委托其他账户代为转移其代币到其他账户。 因此,`bank` 预编译合约在 Stable SDK 现有的 `x/bank` 模块基础上提供了额外的授权和委托功能。 - [桥接安全性与 DVN](/cn/explanation/bridge-security): LayerZero 桥的安全性,完全取决于确认某条链上发送的消息确实在另一条链上发生的验证层。这个层就是去中心化验证者网络(Decentralized Verifier Network,DVN)。本页将解释 DVN 的作用、Stable 如何在其桥上配置 DVN,以及为什么任何单个 DVN 的泄露都不会使 Stable 面临风险。 - [概览](/cn/explanation/build-overview): 初次接触 Stable?请先运行[快速开始](/cn/tutorial/quick-start)。只需五分钟即可发送一笔测试网交易,让本栏其余内容有可对接的基础。 - [隐私转账(Confidential Transfer](/cn/explanation/confidential-transfer): 随着区块链在企业中的应用不断加速,尤其是在稳定币领域,**对交易隐私的需求日益增长**。许多企业在处理财务操作时需要保持隐私性,以保护如付款金额等敏感信息。为满足这一需求,Stable 正在开发**隐私转账(Confidential Transfer)功能**,以在隐私保护与监管合规之间实现平衡。 - [共识](/cn/explanation/consensus): Stable Blockchain 采用 **StableBFT**,这是一种基于 CometBFT 构建的定制化 PoS 共识协议,能够实现高吞吐量、低延迟和强可靠性。StableBFT 提供确定性最终性(区块一经纳入即为最终状态,不存在分叉),并具备拜占庭容错能力,可容忍多达 1/3 的验证者发生故障或恶意行为。 - [合约指南](/cn/explanation/contracts-guides): 合约选项卡下的每个指南、概念和参考,按你想要完成的目标分组。 - [Stable 上的合约](/cn/explanation/contracts-overview): Stable 完全兼容 EVM。Solidity、Vyper、Hardhat、Foundry、ethers.js 和 viem 都无需修改即可使用。只要将工具指向 Stable 的 RPC,现有合约即可原样部署。在标准 EVM 之上,Stable 将协议级模块(Bank、Distribution、Staking)以预编译合约的形式暴露在固定地址上,因此你的 Solidity 可以直接调用质押和奖励分发功能,而无需重新实现它们。 - [核心概念](/cn/explanation/core-concepts): 掌握四个概念就足以开始构建。每个小节都会定义概念、展示示例,并链接到完整参考。 - [概览](/cn/explanation/core-optimization-overview): 一笔区块链交易从提交到最终确认,需要经历多个紧密相连的阶段。交易首先通过 **RPC** 提交,进入 **内存池(mempool)**,被打包进区块后通过 **共识机制** 验证,再由 **状态机(state machine)** 执行,最终写入 **数据库** 进行持久化。只有在完成整个流程后,用户才能收到确认结果。 - [分配模块](/cn/explanation/distribution-module): `distribution` 预编译合约作为桥梁,使 Stable SDK 的 `x/distribution` 模块功能能在 EVM 环境中使用。 - [EIP-7702](/cn/explanation/eip-7702): Stable 支持 EIP-7702,引入了统一账户模型,使外部账户(EOA)可临时以智能账户方式运行。 - [使用签名授权进行结算](/cn/explanation/erc-3009): ERC-3009 允许代币持有者通过签名消息来授权转账。任何人随后都可以提交该签名授权,在链上执行转账。发送方无需直接调用合约。 - [以太坊对比](/cn/explanation/ethereum-comparison): Stable 完全兼容 EVM,因此大多数以太坊工具、库和合约模式无需修改即可使用。下面的章节将逐一介绍从以太坊迁移到 Stable 时哪些保持不变、哪些会改变。 - [与以太坊生态的兼容性](/cn/explanation/ethereum-compatibility): Stable 完全兼容 EVM,使开发者可直接使用以太坊工具、库和智能合约模块,无需进行任何修改。 - [执行层](/cn/explanation/execution): **Stable EVM** 是 Stable 区块链的以太坊虚拟机兼容执行层,使用户能够通过现有的以太坊工具和钱包(如 MetaMask)无缝与链进行交互。Stable EVM 结合了 EVM 的开发体验与 StableSDK 的模块化、高性能基础设施。 - [终局性规则与兼容性保证](/cn/explanation/finality): Stable 的交易在 EVM 执行环境中处理。当交易被打包入区块后,其状态变更立即生效。 - [资金流转](/cn/explanation/flow-of-funds): Stable 是首条专为稳定币支付打造的区块链。该网络针对高吞吐、低延迟的稳定币交易进行了优化,提供 P2P 支付和商户收款,并以 USDT 实现即时结算。应用层的 gas 赞助与减免使服务提供商能够为终端用户提供零手续费的体验,带来主流支付网络般的感受,同时屏蔽了区块链系统的复杂性。 - [Gas 定价机制](/cn/explanation/gas-pricing): Stable 采用单一组成部分的 Gas 费模型: - [Gas 豁免人](/cn/explanation/gas-waiver): Gas 豁免人(免 Gas 费)功能通过允许一小部分经过治理批准的地址("豁免人")提交 `gasPrice = 0` 的交易,实现 Stable 链上终端用户的无 Gas 费交易。Stable 目前运营一个豁免人服务("豁免人服务器"),合作伙伴可以集成该服务,无需实现特定协议的封包逻辑即可提供无 Gas 费用户体验。 - [保证区块空间(Guaranteed Blockspace)](/cn/explanation/guaranteed-blockspace): 随着稳定币的持续发展,越来越多的企业将其纳入财务操作中,例如支付、资金调拨和跨境结算。这一趋势在那些获取稳定法币受限的地区尤为明显。在非洲、拉丁美洲等通货膨胀严重、货币管控严格的市场,稳定币正逐渐成为这些地区企业持续运营的关键工具。 - [高性能 RPC](/cn/explanation/high-performance-rpc): 在构建高性能区块链的过程中,仅仅优化共识机制或出块速度是不够的。**RPC 层** 是区块链与用户之间的接口,是实现端到端用户体验的关键组成部分。Stable 提出一种高性能 RPC 架构,旨在突破传统 RPC 的性能瓶颈。 - [概览](/cn/explanation/integrate-overview): Stable 是一条兼容 EVM 的 Layer 1 区块链,其中 USDT0 是原生 gas 代币。大多数以太坊工具、库和合约模式无需修改即可使用。你只需将 RPC 指向 Stable 并切换 chain ID 即可连接。 - [核心功能](/cn/explanation/key-features): Stable 是一条高性能区块链,专为支持 USDT 相关活动而设计。基于 **委托权益证明(dPoS)** 机制构建,Stable 实现了 **完全兼容 EVM**,并达成 **亚秒级出块时间**,确保交易快速可靠地达成最终性。作为一个 **专注于 USDT 的网络**,Stable 提供了一系列优化用户体验的 USDT 专属功能。 - [学习](/cn/explanation/learn-overview): [**概览**](/cn/explanation/overview) — Stable 是什么,以及如何阅读本文档。 - [MPP 会话](/cn/explanation/mpp-sessions): 会话是一种 MPP 支付意图,它将许多小额支付批量合并为单笔链上结算。客户端只需向托管合约存入一次资金,然后为每个请求签署廉价的链下凭证。只有净额会在链上结算,这使得流式工作负载中每个请求的亚分级经济模型成为可能。 - [Machine Payments Protocol (MPP)](/cn/explanation/mpp): MPP(Machine Payments Protocol,机器支付协议)是一个开放标准,用于在请求 HTTP 资源的同一请求中完成对该资源的付款。它扩展了 [x402](/cn/explanation/x402),新增了支付意图(charge、subscription、session)、多通道支持(稳定币、银行卡、Lightning)、生产特性(幂等性、正文摘要绑定、过期机制)以及额外的传输方式(MCP、WebSocket)。该协议处于 IETF 标准跟踪进程中。 - [概览](/cn/explanation/overview): Stable 是一条以 USDT0 作为原生 gas 代币的 Layer 1,标准的 EVM 工具链(Solidity、Foundry、Hardhat、ethers、viem 以及 `eth_*` JSON-RPC 方法)无需任何改动即可使用。 - [用例概述](/cn/explanation/payment-use-cases-overview): Stable 支持多种支付模式,从简单的钱包到钱包转账,到代理驱动的服务支付。下面的用例涵盖了当今可投入生产的模式。对于即将推出的模式(保证结算、隐私支付、代理间商务),请参阅[即将推出的用例](/cn/explanation/upcoming-use-cases)。 - [支付指南](/cn/explanation/payments-guides): “支付”标签下的每个指南、概念和参考,按你想要完成的任务分组。 - [Stable 上的支付](/cn/explanation/payments-overview): Stable 是围绕支付构建的。USDT0 是原生资产,也是 gas 代币,因此结算和手续费共享同一个余额。单槽终局性(single-slot finality)意味着一笔转账可在一秒内完成。ERC-3009、EIP-7702 和 x402 都是原生基元,而非变通方案——你可以用一个签名完成结算、从委托账户中拉取资金,或者无需运行计费系统即可按 HTTP 请求收费。 - [Stable SDK](/cn/explanation/sdk-overview): `@stablechain/sdk` 是 Stable 的官方 TypeScript 客户端。它对 viem 进行了封装,为你最常用的操作提供了精简的类型化 API:转账 USDT0、在链之间桥接以及在 Stable 上兑换代币。路由、授权、小数位数和链切换都已为你处理好。 - [StableDB](/cn/explanation/stable-db): 区块链端到端性能的主要瓶颈之一是 **磁盘 I/O(Disk I/O)**。尤其是在区块执行后提交和存储状态数据的操作,是性能的关键瓶颈。Stable 通过架构创新,使用如 `MemDB`、`VersionDB` 以及文件内存映射存储(`mmap`),显著提升系统吞吐量。 - [质押模块](/cn/explanation/staking-module): `staking` 预编译合约作为桥梁,使 Stable SDK 的 `x/staking` 模块功能能在 EVM 环境中使用。 - [系统模块](/cn/explanation/system-modules-overview): Stable 的核心协议行为位于 SDK 模块中:`x/bank`、`x/distribution`、`x/staking`。为了让这些行为能从 EVM 访问,Stable 将每个模块作为固定地址上的**预编译合约**暴露出来。用 Solidity 编写的合约直接调用预编译,EVM 会将调用路由到原生 SDK 处理程序。预编译在协议层面实现,使其比等效的 Solidity 重新实现显著更省 gas。 - [System Transactions](/cn/explanation/system-transactions): 系统交易为 Stable 协议提供了一种为 Stable SDK 操作发出 EVM 事件的方式。当质押事件(如解绑完成)在 SDK 层发生时,协议会自动生成发出相应事件的 EVM 交易,使这些操作对 EVM 工具和应用程序完全可见。 - [技术概览](/cn/explanation/tech-overview): 从状态数据库、执行引擎、共识机制,到针对 USDT 的特定优化,Stable 的设计始终聚焦于性能、可扩展性与可靠性。技术栈中的每一层组件都经过专门优化,以支持高吞吐的工作负载和无缝的 USDT 原生操作。 - [技术路线图](/cn/explanation/technical-roadmap): 从用户提交交易到最终结果确认,交易生命周期要经历多个阶段:交易首先通过 RPC 广播,然后进入内存池(mempool),然后被打包进区块,经过共识验证、执行,最终将结果状态写入数据库。只有完成这些步骤,用户才能获得最终的交易结果。 - [即将推出的应用场景](/cn/explanation/upcoming-use-cases): Stable 正在构建超越简单转账和 API 计费的支付模式。下面的案例涵盖了有时间保障的结算、保护隐私的支付以及自主代理商务。其中一些功能目前已有早期形式可用;另一些则依赖于 Stable 目前正在开发中的功能。 - [USDT as Gas](/cn/explanation/usdt-as-gas-token): Stable 是围绕 USDT 稳定币构建的。USDT0 是 USDT 的原生跨链版本,是支撑 Stable 生态系统的核心资产。 - [概览](/cn/explanation/usdt-features-overview): Stable 是一条专为 USDT 打造的 Layer 1 区块链网络。协议的每一个组件都围绕 USDT 的无摩擦转账进行优化,致力于为全球最广泛使用的稳定币提供一个高性能、简洁流畅的运行环境。 - [USDT 转账聚合器](/cn/explanation/usdt-transfer-aggregator): 作为一条专为 USDT 交易优化的区块链,Stable 被设计用于处理极高频次的代币转账,同时保持系统的整体响应。为了在优化 USDT 特定性能的同时兼顾一般交易的多样性,Stable 引入了 USDT 转账聚合器机制。这是一种高效、可扩展的解决方案,可对 USDT0 转账进行高度并行化和容错处理。 - [USDT0 在 Stable 上的行为](/cn/explanation/usdt0-behavior): **如果你正在从以太坊移植合约,请在部署前阅读本页。** Stable 上的 USDT0 既是原生 gas 代币,又是基于同一余额的 ERC-20 代币。因此,四种以太坊上的假定行为会失效:合约的原生余额可能在没有调用该合约的情况下发生变化;`EXTCODEHASH` 可能在零值和空哈希之间来回切换;向零地址转账会回滚;以及由于分数余额对账,一笔逻辑上的转账可能发出多个 `Transfer` 事件。 - [跨链桥接到 Stable](/cn/explanation/usdt0-bridging): USDT 通过两条桥接路径之一进入 Stable,具体取决于它在源链上的形态。这两条路径都会将 USDT0 交付到用户在 Stable 上的钱包。 - [支付与转账](/cn/explanation/use-case-payments): 围绕一种既负责转移资金又支付交易费用的资产构建的 P2P 支付和商户结算。 - [薪资发放与批量支付](/cn/explanation/use-case-payroll): 为员工、承包商和供应商进行大规模支付,具备可预测的吞吐量、可预测的成本,并为敏感金额提供隐私保护。 - [私密转账](/cn/explanation/use-case-private): 资金管理操作、供应商付款和工资发放等场景中,金额具有商业敏感性,不应向全世界公开。 - [赞助和无 gas 体验](/cn/explanation/use-case-sponsored): 有些应用希望从用户体验中彻底移除 gas,让首次使用的用户无需先获取第二种资产即可登录并交易。 - [将 HTTP 端点货币化](/cn/explanation/x402): x402 是一个基于 HTTP 构建的支付协议。服务器返回 `402 Payment Required` 以及付款详情,客户端签署一份 [ERC-3009](/cn/explanation/erc-3009) 授权,促成方在链上结算。整个交换过程通过标准的 HTTP 标头完成。客户端只需要一个钱包:无需注册、无需 API 密钥、无需信用卡登记。