Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.pinata.cloud/llms.txt

Use this file to discover all available pages before exploring further.

The MPP Server is open source and designed to run on Cloudflare Workers. Deploy your own instance to customize pricing, integrate with your own Pinata account, and control the payment flow.

​
Prerequisites

  • Node.js installed
  • Wrangler CLI installed
  • Cloudflare account
  • Pinata account with API key
  • Stripe account with crypto payments enabled

​
Setup

​
1. Clone the Repository

git clone [email protected]:PinataCloud/mpp-server.git
cd mpp-server
npm install

​
2. Configure Environment Variables

Copy the example environment file and fill in your values: 
cp .dev.vars.example .dev.vars
VariableDescription
PINATA_JWTYour Pinata API JWT from the Pinata dashboard
PINATA_GATEWAY_TOKENGateway authentication token
PINATA_GATEWAY_URLYour Pinata gateway domain (e.g., your-gateway.mypinata.cloud)
MPP_SECRET_KEY32-byte hex key for signing 402 challenges
STRIPE_SECRET_KEYStripe API key with crypto payments preview access
Generate an MPP secret key: 
node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"

​
3. Local Development

npm run dev
The server starts at http://localhost:8787.

​
4. Deploy

# Deploy to production
npm run deploy

# Or deploy to a specific environment
npm run deploy:dev
npm run deploy:prod
Set your secrets in Cloudflare (alternative to .dev.vars for deployed environments): 
npx wrangler secret put PINATA_JWT
npx wrangler secret put PINATA_GATEWAY_TOKEN
npx wrangler secret put MPP_SECRET_KEY
npx wrangler secret put STRIPE_SECRET_KEY

​
Architecture

The MPP Server is built with:
ComponentTechnology
RuntimeCloudflare Workers
FrameworkHono
Paymentsmppx SDK
StoragePinata IPFS
BlockchainTempo Mainnet (USDC)
Recipient AddressesStripe PaymentIntents API

​
Request Flow

  1. CORS middleware handles cross-origin requests
  2. MPP middleware intercepts /v1/pin/* routes, calculates pricing, and manages the 402 challenge-response flow
  3. Route handlers create signed Pinata upload URLs or proxy file downloads
  4. Stripe generates unique deposit addresses for each payment

​
Pricing Logic

Upload pricing is calculated per request based on file size: 
price = fileSize (GB) x $0.10 x 12 months
minimum = $0.01 USDC
Download pricing is a flat rate: 
price = $0.01 USDC per download
You can customize these values in src/index.ts.

​
Project Structure

mpp-server/
├── src/
│   ├── index.ts          # App entry, middleware, pricing logic
│   ├── main.ts           # Landing page HTML
│   ├── routes/
│   │   └── pin.ts        # Upload and download handlers
│   └── utils/
│       └── types.ts      # TypeScript types, helper functions
├── wrangler.jsonc        # Cloudflare Workers configuration
├── .dev.vars.example     # Environment variable template
└── package.json

​
Resources