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

Name	Type	Description
Content-Type*	String	"application/json"

Request Body

Name	Type	Description
id*	uint64	Echo. self maintained.
jsonrpc*	String	"2.0"
method*	String	"eth_gasPrice"

200: OK

{
    "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

Name	Type	Description
Content-Type*	String	"application/json"

Request Body

Name	Type	Description
id*	uint64	Echo. self maintained.
jsonrpc*	String	"2.0"
method*	String	"eth_sendPrivateRawTransaction"
params*	[]Tx	Signed transaction (eth_sendRawTransaction style, signed and RLP-encoded)

200: OK Success

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

200: OK Fail

{
    "id": 1,
    "jsonrpc": "2.0",
    "result": "0x" // error for hex
}

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

Name	Type	Description
Content-Type*	String	"application/json"

Request Body

Name	Type	Description
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

200: OK Fail

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

200: OK Success

{
    "jsonrpc":"2.0",
    "id":1,
    "result":"a77f8997-0fc1-4d42-94b2-09d4f79c667d"
}

query puissant api availability

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

200: OK

{
    "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

200: OK

{
    "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"
    }
}

404: Not Found

{
    "message":"tx not found",
    "status":404
}

500: Internal Server Error

{
    "message":"error info",
    "status":500
}

query puissant score for sender/ip

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

Query Parameters

Name	Type	Description
address	String	sender address. if not provided, score of current ip address will be return.

200: OK

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

500: Internal Server Error

{
    "message":"error info",
    "status":500
}