# X402 hands-on

## How it works ?

<figure><img src="/files/LmgRwq2ia8QyVOzficnv" alt=""><figcaption></figcaption></figure>

## Manage wallet & funds

You can generate a key pair with the command:

```bash
cast wallet new
```

For the sake of this document, we will use the following key pairs:

**Client (buyer)**\
Address: `0x2980bc24bBFB34DE1BBC91479Cb712ffbCE02F73`\
Private key: `0x9d2675820d55300a05c8991df217a619bcfdc86e2fd91e56443dbbcf159337fd`

**Server (seller)**\
Address: `0x7553F6FA4Fb62986b64f79aEFa1fB93ea64A22b1`\
Private key: `0xf4f7e165433421377856179c698aa387bd8f872657977bd8fa6d62604f41773c`

You can add funds to your wallet using the [CDP faucet](https://portal.cdp.coinbase.com/products/faucet).

## Getting ready

You need to install Foundry (explained in the README) and those tools:

```bash
npm install -g pnpm
```

Then, you can download the sources:

```bash
git clone git@github.com:coinbase/x402.git
```

## Make it work

Coinbase provides an example server [here](https://github.com/coinbase/x402/tree/main/examples/typescript/servers/express).

```bash
cd x402/examples/typescript/servers/express/
cp .env-local .env
```

Edit .env and have those two lines to `ADDRESS=0x2980bc24bBFB34DE1BBC91479Cb712ffbCE02F73`.

Then you can run the server:

```bash
cd ../../
pnpm install
pnpm build
```

Now, to run the server:

```bash
cd servers/express
pnpm install
pnpm dev
```

Now, we will run a client.

```bash
cd ../../clients/fetch
cp .env-local .env
```

Edit .env and have those two lines to

```
ADDRESS=0x2980bc24bBFB34DE1BBC91479Cb712ffbCE02F73
PRIVATE_KEY=0x9d2675820d55300a05c8991df217a619bcfdc86e2fd91e56443dbbcf159337fd
```

```bash
pnpm install
pnpm dev
```

You will get a message like this:

```
{ report: { weather: 'sunny', temperature: 70 } }
{
  success: true,
  transaction: '0x83645ca1dd0a5a59653748c8a63dd65126a8dd6097ca3f98fe4b27325f2fa92f',
  network: 'base-sepolia',
  payer: '0x2980bc24bBFB34DE1BBC91479Cb712ffbCE02F73'
}
```

The transaction can be seen [here](https://base-sepolia.blockscout.com/tx/0x83645ca1dd0a5a59653748c8a63dd65126a8dd6097ca3f98fe4b27325f2fa92f).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://mogami.gitbook.io/mogami/learning/x402-hands-on.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.