> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentwallex.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 빠른 시작

> 5분 이내에 AgentWallex를 통합하세요 — 에이전트 지갑을 생성하고 첫 번째 결제를 전송합니다.

## 사전 요구 사항

* Node.js 18+ 또는 Python 3.9+
* AgentWallex API 키 (`awx_...`) — [조기 액세스 신청](https://agentwallex.com)
* 블록체인 거래에 대한 기본 이해

## 설치

<CodeGroup>
  ```bash npm theme={null}
  npm install @agentwallex/sdk
  ```

  ```bash yarn theme={null}
  yarn add @agentwallex/sdk
  ```

  ```bash pnpm theme={null}
  pnpm add @agentwallex/sdk
  ```

  ```bash pip theme={null}
  pip install agentwallex
  ```
</CodeGroup>

## 단계별 통합

<Steps>
  <Step title="클라이언트 초기화">
    API 키로 AgentWallex 클라이언트를 생성합니다. 테스트에는 `sandbox`를, 메인넷에는 `production`을 사용하세요.

    <CodeGroup>
      ```typescript TypeScript theme={null}
      import { AgentWallex } from "@agentwallex/sdk";

      const aw = new AgentWallex({
        apiKey: process.env.AGENTWALLEX_API_KEY!,
        environment: "sandbox", // use "production" for mainnet
      });
      ```

      ```python Python theme={null}
      from agentwallex import AgentWallex

      aw = AgentWallex(
          api_key=os.environ["AGENTWALLEX_API_KEY"],
          environment="sandbox",  # use "production" for mainnet
      )
      ```
    </CodeGroup>
  </Step>

  <Step title="에이전트 지갑 생성">
    각 에이전트는 구성 가능한 정책이 적용된 자체 MPC 보안 지갑을 받습니다.

    <CodeGroup>
      ```typescript TypeScript theme={null}
      const agent = await aw.agents.create({
        name: "my-trading-agent",
        chain: "eip155:84532",
        policies: {
          maxTransactionAmount: "100",   // USDC
          dailyLimit: "1000",
          allowedAddresses: ["0x..."],
        },
      });

      console.log(`Agent ID: ${agent.id}`);
      console.log(`Wallet: ${agent.wallet.address}`);
      ```

      ```python Python theme={null}
      agent = await aw.agents.create(
          name="my-trading-agent",
          chain="eip155:84532",
          policies={
              "max_transaction_amount": "100",
              "daily_limit": "1000",
              "allowed_addresses": ["0x..."],
          },
      )

      print(f"Agent ID: {agent.id}")
      print(f"Wallet: {agent.wallet.address}")
      ```
    </CodeGroup>
  </Step>

  <Step title="지갑에 자금 입금">
    에이전트의 지갑 주소로 테스트넷 토큰을 전송합니다. Base Sepolia에서는 [파우셋](https://www.coinbase.com/faucets/base-ethereum-goerli-faucet)을 사용하여 테스트 USDC를 받을 수 있습니다.

    <Note>
      샌드박스 모드에서는 에이전트 지갑이 테스트넷에 있습니다. 실제 자금은 위험에 처하지 않습니다.
    </Note>
  </Step>

  <Step title="결제 전송">
    에이전트를 통해 온체인 결제를 실행합니다.

    <CodeGroup>
      ```typescript TypeScript theme={null}
      const tx = await aw.payments.send({
        agentId: agent.id,
        to: "0xRecipientAddress",
        amount: "10.00",
        token: "USDC",
      });

      console.log(`Transaction hash: ${tx.hash}`);
      console.log(`Status: ${tx.status}`); // "confirmed"
      ```

      ```python Python theme={null}
      tx = await aw.payments.send(
          agent_id=agent.id,
          to="0xRecipientAddress",
          amount="10.00",
          token="USDC",
      )

      print(f"Transaction hash: {tx.hash}")
      print(f"Status: {tx.status}")  # "confirmed"
      ```
    </CodeGroup>
  </Step>
</Steps>

## 내부 동작 원리

1. **정책 검사** — 정책 엔진이 에이전트의 규칙(지출 한도, 주소 화이트리스트, 속도 제어)에 따라 거래를 검증합니다.
2. **MPC 서명** — 2-of-3 임계값 MPC를 사용하여 거래에 서명합니다. 단일 당사자가 전체 키를 보유하지 않습니다.
3. **브로드캐스트** — 서명된 거래가 네트워크에 제출됩니다.
4. **확인** — AgentWallex가 거래를 모니터링하고 확인한 후 웹훅 이벤트를 전달합니다.

## 다음 단계

<CardGroup cols={2}>
  <Card title="TypeScript SDK" icon="js" href="/ko/sdks/typescript">
    모든 메서드와 타입을 포함한 전체 SDK 레퍼런스입니다.
  </Card>

  <Card title="REST API" icon="code" href="/ko/api-reference/overview">
    커스텀 통합을 위한 HTTP 엔드포인트입니다.
  </Card>

  <Card title="x402 소액 결제" icon="credit-card" href="/ko/features/x402-micropayments">
    에이전트의 API 호출당 결제를 활성화하세요.
  </Card>

  <Card title="정책 엔진" icon="shield-check" href="/ko/features/policy-engine">
    지출 제어 및 보안 규칙을 구성하세요.
  </Card>
</CardGroup>