# MultiHopper

MultiHopper is a protocol for scheduled, multi-hop token transfers on Solana. It exposes a REST API and on-chain smart contracts for building programmable payment pipelines: vesting schedules, payroll automation, escrow flows, and treasury distribution.

## How It Works

- Tokens are locked in a program-controlled vault
- Wrapper tokens (Token2022 with permanent delegate) flow through the route
- A permissionless keeper network executes hops and steps on-chain
- An orchestrator manages deployment and sequencing

## Core Concepts

- **Route** — the primary routing primitive; defines hops, recipients, and timing
- **Hop** — a single transfer step within a route
- **Keeper** — permissionless on-chain executor that advances route state
- **Timelock** — on-chain enforcement of scheduled execution windows

## REST API

Base URL: https://www.multihopper.com/api/v1

### Endpoints

- `POST /transfers` — Create a new transfer route
- `POST /transfers/prepare` — Prepare a transaction for signing
- `POST /transfers/submit` — Submit a signed transaction
- `GET  /transfers/:id` — Poll transfer status
- `GET  /transfers` — List and batch query transfers
- `GET  /transfers/estimate` — Estimate fees before creation
- `POST /webhooks` — Register a webhook for transfer events
- `GET  /usage` — Retrieve API usage metrics

### Authentication

API key via `Authorization: Bearer <key>` header.

### OpenAPI Spec

Full OpenAPI 3.1 spec: https://www.multihopper.com/openapi.json
Interactive docs: https://dev-docs.multihopper.com/api-reference/introduction

## MCP Server

An MCP server for documentation and API exploration is available at:
https://dev-docs.multihopper.com/mcp (SSE transport, no auth required)

Tools: `search_multi_hopper`, `query_docs_filesystem_multi_hopper`

## Developer Documentation

Full guides, quickstart, and agentic integration reference:
https://dev-docs.multihopper.com/