API

Designed as Standard RPC Style Endpoint

Access URL

https://puissant-bsc.48.club

wss://puissant-bsc.48.club/ws/ (for 48er NFT holders only)

Query Gas Price Floor

POST /

As of the original eth_gasPrice endpoint.

Query the minimum gas price request for sending transactions via puissant. If the first tx in your puissant has a GasPrice below the floor, your puissant will be rejected instantly.

It barely changes, but this is not a promise.

Headers

NameTypeDescription

Content-Type*

String

"application/json"

Request Body

NameTypeDescription

id*

uint64

Echo. self maintained.

jsonrpc*

String

"2.0"

method*

String

"eth_gasPrice"

{
    "jsonrpc":"2.0",
    "id":1337,
    "result":"0x37e11d600"
}

Send Private Transactions

POST /

Send a Raw Transaction in private mode. Subject to Query Gas Price Floor.

Transaction sent to this RPC will remain inside 48 Club and partner validators without being broadcast, thus will not be packed or only packed by this validator.

Transaction will be handled fully following validation procedure, including but not limit to signature/nonce/gas/gasPrice/balance etc.

Headers

NameTypeDescription

Content-Type*

String

"application/json"

Request Body

NameTypeDescription

id*

uint64

Echo. self maintained.

jsonrpc*

String

"2.0"

method*

String

"eth_sendPrivateRawTransaction"

params*

[]Tx

Signed transaction (eth_sendRawTransaction style, signed and RLP-encoded)

{
    "id": 1,
    "jsonrpc": "2.0",
    "result": "0xdeadbeef883764809a94a5320e4557102f5a3fdd98dabd8cd48773b0eca00666" // tx hash
}

Send Puissant

POST /

If you would like to modify an already-sent puissant, you can send another puissant with the same sender (from addr of the first tx) and raise the gasprice for at least 10%, the previous puissant will be overwritten.

Headers

NameTypeDescription

Content-Type*

String

"application/json"

Request Body

NameTypeDescription

id*

uint64

Echo. self maintained.

jsonrpc*

String

"2.0"

method*

String

"eth_sendPuissant"

params[0].txs*

[]Tx

Signed transactions (eth_sendRawTransaction style, signed and RLP-encoded)

params[0].maxTimestamp*

uint64

puissant valid until timestamp reaches. No more than 2 minutes from now

params[0].acceptReverting

[]TxHash

The array of hash indicated which transaction(s) are allowed to revert

{
    "jsonrpc":"2.0",
    "id":1,
    "error":{
        "code":-32000,
        "message":"known sender"
    }
}

query puissant api availability

GET https://explorer.48.club/api/v1/ping

{
    "message":"pong",
    "status":200
}

query specific puissant status

GET https://explorer.48.club/api/v1/puissant/uuid

uuid is what you get from result of Send Puissant

{
    "message":"",
    "status":200,
    "value":{
        "uuid":":uuid",
        "block":"",
        "validator":"",
        "status":"Pending in puissant queue.",
        "info":"OK.",
        "txs":[
            {
                "tx_hash":"tx_hash",
                "status":"innocent noRun",
                "accept_revert":false,
                "created":"2022-08-02T21:43:53+08:00"
            },
            {
                "tx_hash":"tx_hash",
                "status":"innocent noRun",
                "accept_revert":false,
                "created":"2022-08-02T21:43:53+08:00"
            }
        ],
        "created":"2022-08-02T21:43:53+08:00"
    }
}

query puissant score for sender/ip

GET https://explorer.48.club/api/v1/score

Query Parameters

NameTypeDescription

address

String

sender address. if not provided, score of current ip address will be return.

{
    "message":"ok",
    "status":200,
    "value":{
        "query":"1.1.1.1",
        "score":10,"type":"ip"
    }
}

Last updated