Blockchain Integrations - Solana

This project presents a comprehensive solution for backend integration with the Solana blockchain, employing Rust and the Rocket framework. The system offers essential endpoints for tracking and employing blockchain operations. Prometheus metrics measuring request numbers and response times are added to ensure effective monitoring. Integration tests are implemented for each endpoint using Wiremock for Solana RPC Endpoints to enable offline testing. Project is dockerized and supported with Gitlab CI/CD pipelines.

Usage

• Build the project:

cargo build

• Run the project:

cargo run

• Run tests:

cargo test

• Dockerize the project:

docker build . -t blockchain-solana
docker run --rm -p 8000:8000 blockchain-solana

Note: Address and port numbers are obtained from the environment (include .env file with ROCKET_PORT and ROCKET_ADDRESS to specify)

Endpoints

Endpoints	Description
[GET] /blocks/latest	Get latest block information on the chain
[GET] /blocks/\<slot>	Get block details including transactions on the specified block
[POST] /transactions/sign	Generate signed transaction with given parameters in the request body
[POST] /transactions/send	Send signed transaction to the chain
[GET] /transactions/\<txnHash>/detail	Get detailed information of the specified transaction
[GET] /transactions/\<txnHash>/confirmations	Get confirmation count of the given transaction
[POST] /address	Generate wallet address
[GET] /address/\<address>/balance?\<contract>	Get wallet SOL/token balance
[GET] /fee/estimate?\<contract>	Get a fee estimate for SOL/token transactions

1. Get Latest Block Number

Endpoint: [GET] /blocks/latest

Request body: None

Response:

{
    "height": Int
    "hash": String
}

2. Scan Transactions on Specified Block

Endpoint: [GET] /blocks/\<slot>

Request body: None

Response:

{
    "hash": String,
    "height": Int,
    transactions: [
        {
            "from": [
                {
                    "adress": String,
                    "amount": Float,
                    "contract": String
                },
                {
                    "adress": String,
                    "amount": Float,
                    "contract": String
                }
                , ...
            ],
            "to": [
                {
                    "adress": String,
                    "amount": Float,
                    "contract": String
                }
                , ...
            ],
            "hash": String,
            "status": String,
        }
    ]
}

3. Sign Transaction

Endpoint: [POST] /transactions/sign

Request body:

{
    "from": [
        {
            "adress": String,
            "amount": Float,
            "contract": String
        },
        {
            "adress": String,
            "amount": Float,
            "contract": String
        }
        , ...
    ],
    "to": [
        {
            "adress": String,
            "amount": Float,
            "contract": String
        }
        , ...
    ],
    "privateKey": String
}

Response:

{
    "signedTransaction": String,
    "txnHash": String
}

4. Send Raw Transaction

Endpoint: [POST] /transactions/send

Request body:

{
    "signedTransaction": String
}

Response:

{
    "txnHash": String
}

5. Get Transaction Details

Endpoint: [GET] /transactions/\<txnHash>/detail

Request body: None

Response:

{
    "from":[
        {
            "adress": String,
            "amount": Float,
            "contract": String
        },
        {
            "adress": String,
            "amount": Float,
            "contract": String
        }
        , ...
    ],
    "to":[
        {
            "adress": String,
            "amount": Float,
            "contract": String
        }
        , ...
    ],
    "hash": String,
    "status": String,
    "fee": Float,
    "blockHash": String,
    "blockHeight": Int
}

6. Get Confirmation Count

Endpoint: [GET] /transactions/\<txnHash>/confirmations

Request body: None

Response:

{
    "confirmationsCount": Int
}

7. Create Wallet Address

Endpoint: [POST] /address

Request body: None

Response:

{
    "address": String,
    "privateKey": String
}

8. Get Wallet Balance

Endpoint: [GET] /address/{address}/balance?{contract}

Request body: None

Response:

{
    "balance": Float
}

9. Get Calculated Fees

Endpoint: [GET] /fee/estimate?{contract}

Request body: None

Response:

{
    "calculatedFee": Int
}

Contributors

• Onur Sezen (onursezen@sabanciuniv.edu)

• Doğa Demirtürk (ddemirturk18@ku.edu.tr)