# API

Access URL

{% hint style="info" %}
`https://puissant-bsc.48.club`

`wss://puissant-bsc.48.club/ws/` (for 48er NFT holders only)
{% endhint %}

## Query Gas Price Floor

<mark style="color:green;">`POST`</mark> `/`

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<mark style="color:red;">\*</mark> | String | `"application/json"` |

#### Request Body

| Name                                      | Type   | Description            |
| ----------------------------------------- | ------ | ---------------------- |
| id<mark style="color:red;">\*</mark>      | uint64 | Echo. self maintained. |
| jsonrpc<mark style="color:red;">\*</mark> | String | `"2.0"`                |
| method<mark style="color:red;">\*</mark>  | String | `"eth_gasPrice"`       |

{% tabs %}
{% tab title="200: OK " %}

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

{% endtab %}
{% endtabs %}

## Send Private Transactions

<mark style="color:green;">`POST`</mark> `/`

Send a Raw Transaction in private mode. Subject to [Query Gas Price Floor](#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<mark style="color:red;">\*</mark> | String | `"application/json"` |

#### Request Body

| Name                                      | Type   | Description                                                                |
| ----------------------------------------- | ------ | -------------------------------------------------------------------------- |
| id<mark style="color:red;">\*</mark>      | uint64 | Echo. self maintained.                                                     |
| jsonrpc<mark style="color:red;">\*</mark> | String | `"2.0"`                                                                    |
| method<mark style="color:red;">\*</mark>  | String | `"eth_sendPrivateRawTransaction"`                                          |
| params<mark style="color:red;">\*</mark>  | \[]Tx  | Signed transaction (eth\_sendRawTransaction style, signed and RLP-encoded) |

{% tabs %}
{% tab title="200: OK Success" %}

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

{% endtab %}

{% tab title="200: OK Fail" %}

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

{% endtab %}
{% endtabs %}

## Send Puissant

<mark style="color:green;">`POST`</mark> `/`

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<mark style="color:red;">\*</mark> | String | `"application/json"` |

#### Request Body

| Name                                                      | Type      | Description                                                                 |
| --------------------------------------------------------- | --------- | --------------------------------------------------------------------------- |
| id<mark style="color:red;">\*</mark>                      | uint64    | Echo. self maintained.                                                      |
| jsonrpc<mark style="color:red;">\*</mark>                 | String    | `"2.0"`                                                                     |
| method<mark style="color:red;">\*</mark>                  | String    | `"eth_sendPuissant"`                                                        |
| params\[0].txs<mark style="color:red;">\*</mark>          | \[]Tx     | Signed transactions (eth\_sendRawTransaction style, signed and RLP-encoded) |
| params\[0].maxTimestamp<mark style="color:red;">\*</mark> | 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      |

{% tabs %}
{% tab title="200: OK Fail" %}

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

{% endtab %}

{% tab title="200: OK Success" %}

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

{% endtab %}
{% endtabs %}

## query puissant api availability

<mark style="color:blue;">`GET`</mark> `https://explorer.48.club/api/v1/ping`

{% tabs %}
{% tab title="200: OK " %}

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

{% endtab %}
{% endtabs %}

## query specific puissant status

<mark style="color:blue;">`GET`</mark> `https://explorer.48.club/api/v1/puissant/uuid`

`uuid` is what you get from result of [Send Puissant](#send-puissant)

{% tabs %}
{% tab title="200: OK " %}

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

{% endtab %}

{% tab title="404: Not Found " %}

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

{% endtab %}

{% tab title="500: Internal Server Error " %}

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

{% endtab %}
{% endtabs %}

## query puissant score for sender/ip

<mark style="color:blue;">`GET`</mark> `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. |

{% tabs %}
{% tab title="200: OK " %}

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

{% endtab %}

{% tab title="500: Internal Server Error " %}

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

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.48.club/deprecated/puissant/puissant-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.