Features

Specifications for BARK Actions and Solana Blinks

Overview

---

The BARK Actions Server API is a sophisticated backend service designed to interact with the Solana blockchain, leveraging Node.js and Express. The API allows users to preview, sign, and send blockchain transactions. It supports various transaction types, including donations and payments, and integrates Circle’s USDC gateway for efficient currency management. Key features include support for SOL, USDC, BARK and SPL tokens transactions, enhanced security, flexible donation and payment options, and comprehensive error handling.

The BARK Actions Server API includes the following key features:

1. NFT Minting

• Endpoint: /api/mint

• Description: Allows users to mint a new BARK NFT on the Solana blockchain. Users provide the NFT's name, symbol, and metadata URI.

2. Donations

• SOL Donations:

  • Endpoint: /api/donate/sol

  • Description: Users can donate SOL to a specified treasury address.

• USDC Donations:

  • Endpoint: /api/donate/usdc

  • Description: Users can donate USDC to a specified treasury address.

• BARK Token Donations:

  • Endpoint: /api/donate/bark

  • Description: Users can donate BARK tokens to a specified treasury address.

3. Charity Donations

• Endpoint: /api/charity/donate

• Description: Enables users to make donations to charities using SOL, USDC, or BARK tokens. Users can select predefined or custom amounts and have the option to use escrow for added security.

4. Merchant Payments

• Endpoint: /api/merchant/payment

• Description: Facilitates payments to merchants with support for SOL, USDC, or BARK tokens. Merchants can optionally use escrow for secure transactions.

5. Transaction Preview and Signing

• Preview Transaction:

  • Endpoint: /api/transaction/preview

  • Description: Users can preview transactions before sending them to the Solana blockchain, ensuring accuracy.

• Sign Transaction:

  • Endpoint: /api/transaction/sign

  • Description: Allows users to sign a transaction after previewing it, preparing it for submission to the blockchain.

6. Transaction Tracking

• Endpoint: /api/transaction/track/{transactionId}

• Description: Provides transaction IDs and URLs to view transactions on the Solana Explorer, offering transparency and easy tracking of transactions.

7. Error Handling

• Description: Standardized error responses across all endpoints, providing clear messages when inputs are invalid or when server errors occur.

These features provide a comprehensive suite of tools for interacting with the Solana blockchain, enabling users to mint NFTs, make donations, process payments, and manage transactions with ease and security.