> For the complete documentation index, see [llms.txt](https://docs.aftermath.finance/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.aftermath.finance/ko/perpetuals/architecture/account/gasless-trading.md).

# 가스리스 트레이딩 (GasPool)

중앙 풀에서 에이전트 지갑의 가스를 후원

앱에서는 GasPool을 가스 크레딧이라고 부릅니다. [원클릭 거래](https://docs.aftermath.finance/ko/perpetuals/architecture/account/one-click-trading.md)가 이를 자동으로 설정하고 사용합니다.

봇이나 프로그래매틱 전략을 운영한다면 모든 에이전트 지갑에 가스용 SUI를 채워 둘 필요가 없습니다. **GasPool**이 하나의 선불 잔고에서 에이전트 지갑의 트랜잭션을 후원할 수 있습니다.

GasPool은 선불 가스 카드처럼 작동합니다. 기본 지갑에서 SUI(또는 USDC)를 충전해 두면, 에이전트 지갑이 거래를 실행할 때마다 프로토콜이 풀에서 가스 비용을 차감합니다. 에이전트 지갑은 USDC 담보만 보유하면 됩니다.

## 작동 원리

기본 지갑이 GasPool을 생성하고 자금을 입금한 뒤 에이전트 지갑을 화이트리스트에 등록합니다. 그 이후 에이전트 지갑이 지원되는 거래 엔드포인트를 호출할 때 기본 지갑과 재사용 가능한 약관 서명을 담은 `sponsor` 필드를 포함합니다. API는 트랜잭션을 구성하고 풀에서 가스를 끌어온 다음 `txKind`와 `sponsorSignature`를 함께 반환합니다. 에이전트 지갑은 트랜잭션에 서명하고 두 서명을 모두 첨부해 제출합니다.

에이전트 지갑은 SUI를 전혀 다루지 않습니다. 잔고가 부족해지면 기본 지갑에서 GasPool을 충전하십시오.

## 설정

### 1단계: GasPool 생성

기본 지갑에서 단일 트랜잭션으로 GasPool을 생성하고 자금을 입금합니다.

**엔드포인트:** `POST /api/gas-pool/transactions/create`

```json
{
  "walletAddress": "<your-primary-wallet>",
  "deferShare": false,
  "initialDepositAmount": "1000000000n"
}
```

`initialDepositAmount`의 단위는 MIST입니다(1 SUI = 1,000,000,000 MIST). 나중에 입금할 수도 있습니다.

### 2단계: 입금(선택적 추가 충전)

**엔드포인트:** `POST /api/gas-pool/transactions/deposit`

SUI를 직접 입금:

```json
{
  "walletAddress": "<your-primary-wallet>",
  "amount": "500000000n"
}
```

또는 USDC(또는 다른 코인)를 입금합니다. 엔드포인트가 입금 전에 Aftermath 라우터를 통해 자동으로 SUI로 스왑합니다.

```json
{
  "walletAddress": "<your-primary-wallet>",
  "coinType": "0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC",
  "amount": "5000000n",
  "slippage": 0.01
}
```

SUI를 보유하지 않아도 이미 가지고 있는 토큰으로 GasPool에 자금을 넣을 수 있습니다.

### 3단계: 에이전트 지갑에 접근 권한 부여

**엔드포인트:** `POST /api/gas-pool/transactions/grant`

```json
{
  "walletAddress": "<your-primary-wallet>",
  "targetWalletAddress": "<your-agent-wallet>"
}
```

### 4단계: 후원 거래 실행

에이전트 지갑에서 `/api/perpetuals/account/transactions/...` 엔드포인트를 호출할 때 `sponsor` 필드를 포함합니다.

```json
{
  "walletAddress": "<your-agent-wallet>",
  "accountId": "424n",
  "sponsor": {
    "walletAddress": "<your-primary-wallet>",
    "bytes": "<base64 of Aftermath Terms and Conditions>",
    "signature": "<primary-wallet signature>",
    "gasBudget": 50000000
  }
}
```

`gasBudget`은 선택 사항이며 단위는 MIST입니다. 생략하면 서비스가 예산을 정합니다. 정확한 UTF-8 메시지 `Aftermath Terms and Conditions`에 서명하고, 그 base64 표현을 `bytes`로 보내며, 지갑 연결에는 같은 서명을 재사용하십시오.

API는 다음을 반환합니다.

* `txKind`: 에이전트 지갑이 서명할 base64 인코딩 트랜잭션
* `sponsorSignature`: 가스 스폰서의 서명

에이전트 지갑이 `txKind`에 서명한 뒤, 두 서명을 모두 첨부해 트랜잭션을 제출합니다.

## GasPool 관리

| 작업             | 엔드포인트                                      |
| -------------- | ------------------------------------------ |
| 잔고 및 화이트리스트 확인 | `POST /api/gas-pool/pool`                  |
| 추가 입금          | `POST /api/gas-pool/transactions/deposit`  |
| SUI 출금         | `POST /api/gas-pool/transactions/withdraw` |
| 접근 권한 부여       | `POST /api/gas-pool/transactions/grant`    |
| 접근 권한 회수       | `POST /api/gas-pool/transactions/revoke`   |
| 지연된 풀 공유       | `POST /api/gas-pool/transactions/share`    |
| 트랜잭션 직접 후원     | `POST /api/gas-pool/transactions/sponsor`  |

### PTB 구성

풀을 생성할 때 `deferShare: true`를 설정하면 `gasPoolArg`와 `sharePolicyArg`를 받을 수 있으며, 같은 구성 트랜잭션 안에서 나중에 이 인수를 `/api/gas-pool/transactions/share`에 전달합니다. 입금은 기존 `txKind`와 `coinArg`를 사용할 수 있습니다. 출금은 `deferTransfer: true`를 설정해 다른 PTB 명령에 쓸 `withdrawnCoinArg`를 받을 수 있습니다.

직접 후원 엔드포인트는 재사용 가능한 약관 서명, 선택적 `txKind`, 선택적 MIST 단위 `gasBudget`을 받습니다. `transaction`, `sponsorSignature`, `digest`를 반환하며, 송신자로서 `transaction`에 서명한 뒤 두 서명을 모두 제출합니다.

GasPool 실패에는 고정된 오류 코드가 사용됩니다. 잔액 부족은 `2030`, 서비스 일시 사용 불가는 `2031`, 권한 실패는 `2032`, 트랜잭션을 후원할 수 없는 경우는 `2033`입니다. 서명 검증 실패는 `2034`를 사용합니다.

## 대안: 로컬 스폰서십

GasPool을 사용하고 싶지 않다면, 제출 전에 기본 지갑이 가스 스폰서로서 트랜잭션 페이로드에 공동 서명하는 방식으로 직접 후원할 수도 있습니다. GasPool 없이 후원을 완전히 제어할 수 있습니다.
