quicknode

Files (2)

• SKILL.md
• metadata.json

SKILL.md (first lines)

# Quicknode

Blockchain RPC and data access via Quicknode. Use this skill when an agent needs to read onchain data such as balances, token prices, transaction status, gas estimates, block data, NFT ownership, or Solana assets.

Source: https://github.com/BankrBot/skills/tree/main/quicknode

## Access Modes

Quicknode supports two common access modes for agents.

## API Key Access

Quicknode endpoints include authentication in the endpoint URL:

```text
https://{ENDPOINT_NAME}.{NETWORK}.quiknode.pro/{API_KEY}/
```

Example with `viem`:

```typescript
import { createPublicClient, http } from "viem";
import { base } from "viem/chains";

const client = createPublicClient({
  chain: base,
  transport: http(process.env.QUICKNODE_RPC_URL),
});

const block = await client.getBlockNumber();
```

## x402 Access

x402 allows wallet-based pay-per-request access without a Quicknode account. Treat wallet credentials as signing credentials and do not paste or commit private keys.

```typescript
import { createQuicknodeX402Client } from "@quicknode/x402";

const client = await createQuicknodeX402Client({
  baseUrl: "https://x402.quicknode.com",
  network: "eip155:84532",
  evmPrivateKey: process.env.QUICKNODE_X402_PRIVATE_KEY,
  preAuth: true,
});

const res = await client.fetch("https://x402.quicknode.com/ethereum-mainnet", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ jsonrpc: "2.0", method: "eth_blockNumber", params: [], id: 1 }),
});
```

Install:

```bash
npm install @quicknode/x402
```

## Common Agent Operations

## Check Native Balance

```typescript
const balance = await client.getBalance({ address: "0x..." });
```

Raw EVM RPC:

```json
{ "jsonrpc": "2.0", "method": "eth_getBalance", "params": ["0x...", "latest"], "id": 1 }
```

## Check ERC-20 Balance

Use `eth_call` with the ERC-20 `balanceOf(address)` selector `0x70a08231`.

```json
{
  "jsonrpc": "2.0",
  "method": "eth_call",
  "params": [{
    "to": "0xTOKEN_CONTRACT",
    "data": "0x70a08231000000000000000000000000WALLET_ADDRESS_NO_0x"
  }, "latest"],
  "id": 1
}
```

## Estimate Gas Price

```json
{ "jsonrpc": "2.0", "method": "eth_gasPrice", "params": [], "id": 1 }
```

## Check Transaction Status

```json
{ "jsonrpc": "2.0", "method": "eth_getTransactionReceipt", "params": ["0xTX_HASH"], "id": 1 }
```

## Solana Balance

```json
{ "jsonrpc": "2.0", "method": "getBalance", "params": ["WALLET_PUBKEY"], "id": 1 }
```

## Solana Token Accounts

```json
{
  "jsonrpc": "2.0",
  "method": "getTokenAccountsByOwner",
  "params": [
    "WALLET_PUBKEY",
    { "programId": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA" },
    { "encoding": "jsonParsed" }
  ],
  "id": 1

From wakumo/awesome-web3-agent-skills, MIT.

More from wakumo/awesome-web3-agent-skills