# Send Pump Sdk Core to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "pump-sdk-core",
    "name": "Pump Sdk Core",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/speraxos/pump-sdk-core",
    "canonicalUrl": "https://clawhub.ai/speraxos/pump-sdk-core",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/pump-sdk-core",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=pump-sdk-core",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "pump-sdk-core",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-03T06:33:01.636Z",
      "expiresAt": "2026-05-10T06:33:01.636Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=pump-sdk-core",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=pump-sdk-core",
        "contentDisposition": "attachment; filename=\"pump-sdk-core-0.1.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "pump-sdk-core"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/pump-sdk-core"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/pump-sdk-core",
    "downloadUrl": "https://openagent3.xyz/downloads/pump-sdk-core",
    "agentUrl": "https://openagent3.xyz/skills/pump-sdk-core/agent",
    "manifestUrl": "https://openagent3.xyz/skills/pump-sdk-core/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/pump-sdk-core/agent.md"
  }
}
```
## Documentation

### Pump SDK Core — Instruction Building & On-Chain Interaction

Build, extend, and maintain the core Pump SDK — an offline-first TypeScript SDK that constructs Solana TransactionInstructions for token creation, buying, selling, migration, and creator fee collection across three on-chain programs (Pump, PumpAMM, PumpFees) plus the Mayhem program.

### Context

The SDK is published as @pump-fun/pump-sdk (npm) and powers the Pump protocol — a Solana-based token launchpad with bonding curve pricing, automatic AMM migration after graduation, tiered fees, and creator fee sharing. The codebase uses Anchor for IDL-based instruction building and supports both Token (SPL) and Token-2022 token programs.

### Key Files

src/sdk.ts — PumpSdk class with all instruction builders and account decoders
src/onlineSdk.ts — OnlinePumpSdk class extending offline SDK with live RPC fetches
src/index.ts — barrel re-export module defining the public API surface
src/state.ts — TypeScript interfaces for all on-chain account state
src/pda.ts — Program Derived Address derivation for all programs
src/idl/pump.ts, src/idl/pump_amm.ts, src/idl/pump_fees.ts — Anchor IDL definitions

### Architecture

Offline SDK (PumpSdk): Builds instructions without a live connection. Uses Anchor Program instances initialized with a dummy keypair and connection. Exported as a singleton PUMP_SDK.
Online SDK (OnlinePumpSdk): Wraps PumpSdk with a real Connection for fetching account state via getMultipleAccountsInfo. Provides "BothPrograms" methods that aggregate data across bonding curve (Pump) and AMM (PumpAMM) programs.
Three program IDs: PUMP_PROGRAM_ID, PUMP_AMM_PROGRAM_ID, PUMP_FEE_PROGRAM_ID, plus MAYHEM_PROGRAM_ID for mayhem-mode tokens.

### Instruction Builder Pattern

Every instruction method returns TransactionInstruction[] (not transactions), allowing callers to compose them into transactions freely. Methods follow a naming convention:

*Instruction — single instruction
*Instructions — multiple instructions (e.g., ATA creation + buy)

### Account Decoders

The SDK decodes raw AccountInfo<Buffer> into typed interfaces using the Anchor coder:

decodeGlobal, decodeBondingCurve, decodeFeeConfig, decodeSharingConfig, etc.
Nullable variants (e.g., decodeBondingCurveNullable) handle missing or undersized accounts gracefully.

### Slippage Calculation

maxSolCost = solAmount + (solAmount × slippage × 10 / 1000)
minSolReceived = solAmount - (solAmount × slippage × 10 / 1000)

### Patterns to Follow

Always return TransactionInstruction[] from instruction builders, never full Transaction objects
Use getMultipleAccountsInfo to batch RPC calls (2–3 accounts per call)
Support both Token (SPL) and Token-2022 programs via tokenProgram parameter
Handle account extension (extendAccountInstruction) for bonding curves that need more space
Validate shareholder arrays: max 10 shareholders, shares must total 10,000 bps, no duplicates, no zero shares
Use typed error classes from src/errors.ts for validation failures
Keep the offline SDK connection-free; all RPC calls belong in OnlinePumpSdk

### Common Pitfalls

Circular dependency between sdk.ts and onlineSdk.ts
Buy instruction passes { 0: true } as a flags argument — this is intentional, not a bug
BONDING_CURVE_NEW_SIZE = 151 — accounts may need extension before certain operations
BondingCurve.complete === true means the token has graduated to AMM — bonding curve operations will fail
The createInstruction (v1) is deprecated in favor of createV2Instruction (Token-2022)
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: speraxos
- Version: 0.1.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-03T06:33:01.636Z
- Expires at: 2026-05-10T06:33:01.636Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/pump-sdk-core)
- [Send to Agent page](https://openagent3.xyz/skills/pump-sdk-core/agent)
- [JSON manifest](https://openagent3.xyz/skills/pump-sdk-core/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/pump-sdk-core/agent.md)
- [Download page](https://openagent3.xyz/downloads/pump-sdk-core)