@skalenetwork/mpp

SKALE payment method for MPP (Machine Payments Protocol)

Enables private, gasless payments on SKALE Network using confidential tokens with BITE encryption and EIP-3009 gasless transfers.

Installation

npm install @skalenetwork/mpp
# or
pnpm add @skalenetwork/mpp
# or
yarn add @skalenetwork/mpp

Quick Start

import { mpp } from '@skalenetwork/mpp/client'

// Standard transfer on SKALE Base
const method = mpp.charge({
  chain: 'skale-base',
  currency: 'USDC.e'
})

// Gasless with EIP-3009
const gaslessMethod = mpp.charge({
  chain: 'skale-base',
  currency: 'USDC.e',
  extensions: { gasless: 'eip3009' }
})

// Encrypted (BITE Phase I)
const encryptedMethod = mpp.charge({
  chain: 'skale-base',
  currency: 'USDC.e',
  extensions: { skale: { encrypted: true } }
})

// Confidential token (BITE Phase II) + gasless
const confidentialMethod = mpp.charge({
  chain: 'bite-sandbox',
  currency: 'eUSDC',
  extensions: {
    skale: { encrypted: true, confidentialToken: true },
    gasless: 'eip3009'
  }
})

Supported Chains

Chain	Network	Chain ID
skale-base	SKALE Base Mainnet	284351530983
skale-base-sepolia	SKALE Base Testnet	2024883468
bite-sandbox	BITE Sandbox Testnet	103698795
base	Base Mainnet	8453
base-sepolia	Base Sepolia	84532

Extensions

Gasless

Enable gasless payments via EIP-3009 or EIP-2612 permit:

extensions: { gasless: 'eip3009' }  // Default gasless mode
extensions: { gasless: 'eip2612' }  // ERC-2612 permit
extensions: { gasless: true }       // Auto-detect EIP-3009

BITE Encryption (Phase I)

Encrypt transfer amounts on-chain:

extensions: { skale: { encrypted: true } }

Confidential Tokens (Phase II)

Use native confidential tokens with BITE:

extensions: {
  skale: {
    encrypted: true,
    confidentialToken: true
  }
}

Payment Strategies

Chain	Currency	Gasless	Encrypted	Confidential Token	Mode
skale-base	USDC.e	-	-	-	Standard transfer
skale-base	USDC.e	EIP-3009	-	-	Gasless permit
skale-base	USDC.e	-	✓	-	Encrypted amount
skale-base	USDC.e	EIP-3009	✓	-	Gasless + encrypted
bite-sandbox	eUSDC	-	-	✓	Confidential token
bite-sandbox	eUSDC	EIP-3009	-	✓	Confidential + gasless
bite-sandbox	eUSDC	-	✓	✓	Confidential + encrypted
bite-sandbox	eUSDC	EIP-3009	✓	✓	Full privacy (all)

Custom Chains

Use any viem Chain object:

import { mpp } from '@skalenetwork/mpp/client'
import { defineChain } from 'viem'

const myChain = defineChain({
  id: 123456,
  name: 'My Chain',
  nativeCurrency: { name: 'ETH', symbol: 'ETH', decimals: 18 },
  rpcUrls: {
    default: { http: ['https://mychain.rpc'] }
  }
})

const method = mpp.charge({
  chain: myChain,
  currency: {
    address: '0xTokenAddress...',
    symbol: 'TOKEN',
    decimals: 18,
    eip3009: true
  }
})

Server Usage

import { mpp } from '@skalenetwork/mpp/server'

const method = mpp.charge({
  chain: 'skale-base',
  currency: 'USDC.e',
  extensions: { gasless: 'eip3009' }
})

// In your MPPx server setup
const mppx = Mppx.create({
  methods: [method],
  realm: 'api.example.com',
  secretKey: process.env.MPP_SECRET
})

License

MIT