mintBlue SDK
SDK Server

7min
mintBlue offers its' SDK functionality through a REST API. This SDK Server allows you to use the functionalities of the SDK, without having to integrate the SDK package in your solution. It's particulary meant to decrease implementation time and allow an easy way to set up proof of concepts, but also to easily integrate the functionality into non-JavaScript environments.
You can find the full specification of the SDK here﻿
JSON-RPC
The SDK Server implements a JSON-RPC specification, so there are a uniform set of methods that clients can rely on. JSON-RPC is a stateless, light-weight remote procedure call (RPC) protocol. It defines several data structures and the rules around their processing. MintBlue clients using the SDK server may utilize different programming languages when implementing the JSON-RPC specification.
More about the JSON-RPC specification can be found here﻿
Connecting the SDK Server
Check the  mintBlue Quick Start Guide﻿ for more information on creating access tokens and projects
You can find the SDK Server at http://api.mintblue.com/sdk
The SDK Server uses SDK tokens for authentication. Provide the SDK token in your HTTP headers under key mintblue-sdk-token. Make sure your content-type is set to application/json. Below, an example request is shown.
Curl
curl --request POST 'https://api.mintblue.com/sdk' \
--header 'mintblue-sdk-token: secret-token:mintBlue.com/sdk/some-secret' \
--header 'Content-Type: application/json' \
--data-raw '
{ 
    "id": "1", 
    "jsonrpc": "2.0", 
    "method": "listProjects", 
    "params": {}
}'
curl --request POST 'https://api.mintblue.com/sdk' \
--header 'mintblue-sdk-token: secret-token:mintBlue.com/sdk/some-secret' \
--header 'Content-Type: application/json' \
--data-raw '
{ 
    "id": "1", 
    "jsonrpc": "2.0", 
    "method": "listProjects", 
    "params": {}
}'
﻿
All buffer values need to be converted to base64, and provided as a string preceded by base64:

Example: "base64:ZXhhbXBsZSB0ZXh0IGJhc2U2NCBmb3JtYXQ="
Example
Create a Peppol Transaction
In this example we create a Peppol Output on the blockchain, using the SDK Server over JSON-RPC.
Curl
curl --request POST 'https://api.mintblue.com/sdk' \
--header 'mintblue-sdk-token: secret-token:mintBlue.com/sdk/some-secret' \
--header 'Content-Type: application/json' \
--data-raw '
{ 
    "id": "1", 
    "jsonrpc": "2.0", 
    "method": "createTransaction", 
    "params": {
        "project_id": "8a4bffc4-55ff-404f-a082-bf6f1a9ca5fa",
        "outputs": [
            {
                "type": "peppol",
                "version": 1,
                "pubKey": "0451e5f5d3b4d8bc236dc406d31404074e7d112dc8922c2549120f3dc24e32215999880deb21a76be8ed401749f711e8be9652215b2dd3d99654c6f72d443b0d28",
                "value": "base64:dGVzdA=="
            }
        ]
    }
}'

# result
{
    "jsonrpc": "2.0",
    "id": "1",
    "result": {
        "txid": "78b395c593a04757f708faed3de7cd1891ec5480c12e7f876c48aae6730356c1",
        "rawtx": "0100000001aa7a7f21ec2399d20ba3ce20d631d920a26fddae7f8654f3beaf0a76b7fe8500010000006a473044022045473e139d0ef6987ffe8858597c27ff2f77e0ed1b69c044180ff23be337dfa5022074e621b80c2ced4deff4850909d969bbdda505d573223b182e611b145ba1d66c412102a5d85cb396ab565e22043e8d530f3338b575f87d5cbcbc38b28f1620e293d7cdffffffff020000000000000000fd6b01006a096d423a706570706f6c4d5c01a56a636970686572746578745819e5ae753d789e39c614643998d4f21fbd7677f97a6f533f64ff6269764c90fe55fcffd3d624adab0ac86a726563697069656e747381a26d656e637279707465645f6b65797836734c726a65582d625759476f716e5165614342344d7672305661334b546d3139774b6d414263664d39486b54556c696373456a33514166686561646572a163616c676e454344482d45532b413235364b576374616750876bd70b0003f683053a47928ee7f63f6970726f74656374656458967b22656e63223a224132353647434d222c2265706b223a7b2278223a22754e77464b75574b66633949562d4b5335336c71474b3331575363553364494d4d76324c693572725f4a77222c22637276223a22502d323536222c226b7479223a224543222c2279223a224d75574b4b48676c7a71324f326d4a656e41315a5f6755514a426d4b34475a5477674d626d31637468756f227d7d4d260000000000001976a91448d680c3db858407487a6a7a91dbb29899bfd48488ac00000000"
    }
}

curl --request POST 'https://api.mintblue.com/sdk' \
--header 'mintblue-sdk-token: secret-token:mintBlue.com/sdk/some-secret' \
--header 'Content-Type: application/json' \
--data-raw '
{ 
    "id": "1", 
    "jsonrpc": "2.0", 
    "method": "createTransaction", 
    "params": {
        "project_id": "8a4bffc4-55ff-404f-a082-bf6f1a9ca5fa",
        "outputs": [
            {
                "type": "peppol",
                "version": 1,
                "pubKey": "0451e5f5d3b4d8bc236dc406d31404074e7d112dc8922c2549120f3dc24e32215999880deb21a76be8ed401749f711e8be9652215b2dd3d99654c6f72d443b0d28",
                "value": "base64:dGVzdA=="
            }
        ]
    }
}'

# result
{
    "jsonrpc": "2.0",
    "id": "1",
    "result": {
        "txid": "78b395c593a04757f708faed3de7cd1891ec5480c12e7f876c48aae6730356c1",
        "rawtx": "0100000001aa7a7f21ec2399d20ba3ce20d631d920a26fddae7f8654f3beaf0a76b7fe8500010000006a473044022045473e139d0ef6987ffe8858597c27ff2f77e0ed1b69c044180ff23be337dfa5022074e621b80c2ced4deff4850909d969bbdda505d573223b182e611b145ba1d66c412102a5d85cb396ab565e22043e8d530f3338b575f87d5cbcbc38b28f1620e293d7cdffffffff020000000000000000fd6b01006a096d423a706570706f6c4d5c01a56a636970686572746578745819e5ae753d789e39c614643998d4f21fbd7677f97a6f533f64ff6269764c90fe55fcffd3d624adab0ac86a726563697069656e747381a26d656e637279707465645f6b65797836734c726a65582d625759476f716e5165614342344d7672305661334b546d3139774b6d414263664d39486b54556c696373456a33514166686561646572a163616c676e454344482d45532b413235364b576374616750876bd70b0003f683053a47928ee7f63f6970726f74656374656458967b22656e63223a224132353647434d222c2265706b223a7b2278223a22754e77464b75574b66633949562d4b5335336c71474b3331575363553364494d4d76324c693572725f4a77222c22637276223a22502d323536222c226b7479223a224543222c2279223a224d75574b4b48676c7a71324f326d4a656e41315a5f6755514a426d4b34475a5477674d626d31637468756f227d7d4d260000000000001976a91448d680c3db858407487a6a7a91dbb29899bfd48488ac00000000"
    }
}
﻿
List a Project's Transactions
Curl
curl --request POST 'https://api.mintblue.com/sdk' \
--header 'mintblue-sdk-token: secret-token:mintBlue.com/sdk/some-secret' \
--header 'Content-Type: application/json' \
--data-raw '
{ 
    "id": "1", 
    "jsonrpc": "2.0", 
    "method": "listTransactions", 
    "params": {
        "project_id": "8a4bffc4-55ff-404f-a082-bf6f1a9ca5fa"
    }
}'

# result
{
    "jsonrpc": "2.0",
    "id": "1",
    "result": [
        {
            "txid": "78b395c593a04757f708faed3de7cd1891ec5480c12e7f876c48aae6730356c1",
            "status": 2,
            "block": null,
            "metadata": null,
            "privdata": {
                "bsveur": 54.78702618210238,
                "totalStripeEur": 0,
                "envelopeHeaders": []
            },
            "project_id": "8a4bffc4-55ff-404f-a082-bf6f1a9ca5fa",
            "user_id": "cfc76f0c-37dd-480d-9e72-0050a003083f",
            "size": 565,
            "created_at": "2022-07-25T16:35:40.832Z",
            "published_at": "2022-07-25T16:35:40.832Z",
            "confirmed_at": null,
            "count": "1"
        },
        
    ]
}

curl --request POST 'https://api.mintblue.com/sdk' \
--header 'mintblue-sdk-token: secret-token:mintBlue.com/sdk/some-secret' \
--header 'Content-Type: application/json' \
--data-raw '
{ 
    "id": "1", 
    "jsonrpc": "2.0", 
    "method": "listTransactions", 
    "params": {
        "project_id": "8a4bffc4-55ff-404f-a082-bf6f1a9ca5fa"
    }
}'

# result
{
    "jsonrpc": "2.0",
    "id": "1",
    "result": [
        {
            "txid": "78b395c593a04757f708faed3de7cd1891ec5480c12e7f876c48aae6730356c1",
            "status": 2,
            "block": null,
            "metadata": null,
            "privdata": {
                "bsveur": 54.78702618210238,
                "totalStripeEur": 0,
                "envelopeHeaders": []
            },
            "project_id": "8a4bffc4-55ff-404f-a082-bf6f1a9ca5fa",
            "user_id": "cfc76f0c-37dd-480d-9e72-0050a003083f",
            "size": 565,
            "created_at": "2022-07-25T16:35:40.832Z",
            "published_at": "2022-07-25T16:35:40.832Z",
            "confirmed_at": null,
            "count": "1"
        },
        
    ]
}
﻿
Decode and Decrypt a Transaction
Curl
curl --request POST 'https://api.mintblue.com/sdk' \
--header 'mintblue-sdk-token: secret-token:mintBlue.com/sdk/some-secret' \
--header 'Content-Type: application/json' \
--data-raw '
{ 
    "id": "1", 
    "jsonrpc": "2.0", 
    "method": "getTransaction", 
    "params": ["78b395c593a04757f708faed3de7cd1891ec5480c12e7f876c48aae6730356c1"]
}'

# result
{
    "jsonrpc": "2.0",
    "id": "1",
    "result": [
        {
            "type": "peppol",
            "version": 1,
            "value": "base64:dGVzdA==",
            "options": {
                "extra": null
            }
        },
        {
            "type": "payment",
            "to": "17e8cjxmy4RJLxqw3QR7UdsCd1wp4dV8WR",
            "satoshis": 9935
        }
    ]
}

curl --request POST 'https://api.mintblue.com/sdk' \
--header 'mintblue-sdk-token: secret-token:mintBlue.com/sdk/some-secret' \
--header 'Content-Type: application/json' \
--data-raw '
{ 
    "id": "1", 
    "jsonrpc": "2.0", 
    "method": "getTransaction", 
    "params": ["78b395c593a04757f708faed3de7cd1891ec5480c12e7f876c48aae6730356c1"]
}'

# result
{
    "jsonrpc": "2.0",
    "id": "1",
    "result": [
        {
            "type": "peppol",
            "version": 1,
            "value": "base64:dGVzdA==",
            "options": {
                "extra": null
            }
        },
        {
            "type": "payment",
            "to": "17e8cjxmy4RJLxqw3QR7UdsCd1wp4dV8WR",
            "satoshis": 9935
        }
    ]
}
﻿
﻿
Updated 25 Jul 2023
Did this page help you?
SDK Encryption
Envelopes
Docs powered by Archbee
TABLE OF CONTENTS
JSON-RPC
Connecting the SDK Server
Example
Create a Peppol Transaction
List a Project's Transactions
Decode and Decrypt a Transaction