Solana DePIN · x402 Protocol · AI-Native Payments

Solinkify SDK & Protocol ⚡

Decentralized payment infrastructure on Solana designed to bridge digital assets with Merchants (E-commerce) and Autonomous AI Agents (M2M).

Anchor Smart Contracts · Rust (Axum) Backend · Plug-and-Play JavaScript SDK

Key Features

DePIN Payment Gateway

Third-party merchants accept SINKY, USDC, USDT, and PYUSD with automatic fee-splitting — no Web3 complexity.

x402 Protocol (M2M)

AI agents autonomously purchase digital assets. No human intervention needed.

Solana Blinks Ready

Direct transaction integration via social media (Twitter/X) out of the box.

Idempotency & Security

Replay attack protection via on-chain + off-chain signature verification.

SDK Installation

Use NPM or Yarn to integrate Solinkify into your project:

bash
npm install solinkify-sdk

Merchant Integration (E-commerce)

Accept Solana payments without touching Web3 complexity.

Option A — Vanilla JS / Node.jsBasic HTML or simple backends
javascript
import { SolinkifyMerchant } from 'solinkify-sdk';

const merchant = new SolinkifyMerchant();

async function handlePayment() {
    // 1. Get a ready-to-use transaction from Solinkify
    const tx = await merchant.createPaymentTransaction(
        "YOUR_STORE_WALLET",
        "BUYER_WALLET",
        0.1,             // Amount in SOL
        "ORDER-12345"    // Order ID
    );

    // 2. Request approval from the buyer's wallet (Phantom, etc.)
    const provider = window.phantom?.solana;
    const { signature } = await provider.signAndSendTransaction(tx);
    
    console.log("Payment Successful! TxID:", signature);
}
Option B — React / Next.js (Wallet Adapter)Modern checkout button
tsx
import { useWallet } from '@solana/wallet-adapter-react';
import { Connection } from '@solana/web3.js';
import { SolinkifyMerchant } from 'solinkify-sdk';

export default function CheckoutButton() {
    const { publicKey, sendTransaction } = useWallet();
    const connection = new Connection("https://api.devnet.solana.com");

    const handleCheckout = async () => {
        if (!publicKey) return alert("Please connect your wallet first!");
        try {
            const merchantApi = new SolinkifyMerchant();
            const tx = await merchantApi.createPaymentTransaction(
                "YOUR_STORE_WALLET", 
                publicKey.toBase58(), 
                0.1, 
                "INV-REACT-001"
            );
            const signature = await sendTransaction(tx, connection);
            alert(`Payment Successful! TxID: ${signature}`);
        } catch (error) {
            console.error("Payment failed:", error);
        }
    };

    return (
        <button onClick={handleCheckout}>
            Pay 0.1 SOL via Phantom
        </button>
    );
}

Protocol Information (On-Chain)

Program IDAaKvuhidmnrpXdHi762sJ1xZ5TrjragS9Y6ikwFVp1tr
NetworkSolana Devnet (Testing Phase)
Base Fee1% (Min: 0.00015 SOL · Max: 0.05 SOL)
Revenue Split75% → Node Operator · 25% → Admin

API Reference (Off-Chain)

Base URL: https://api.solinkify.com/

EndpointMethodDescription
/gateway/create-paymentPOSTCreates an unsigned M2M transaction with fee split instructions for the Merchant.
/x402/book/:idGETRequests an invoice or downloads an asset (requires 3 Security Headers).
/actions/buy/:idGET/POSTNative endpoint for the Solana Blinks standard.
/booksGETRetrieves the list of live digital assets in the database.

Security Headers

If you are not using the SolinkifyAgent module and making manual API calls, include these 3 headers in the second GET request (after on-chain payment):

x-payment-signatureTxID (Signature) of your SOL transfer proof on Solana.
x-buyer-pubkeyThe Public Key of the wallet used to pay.
x-auth-signatureEd25519 signature of the message `${book_id}:${signature}` using the buyer's private key.

Solinkify

Empowering the Machine-to-Machine Economy on Solana.

Distributed under the ISC License · Part of the Solinkify ecosystem