150 lines
3.7 KiB
Markdown
150 lines
3.7 KiB
Markdown
|
|
|
|
@polkadot/rpc-provider/https
|
|
============================
|
|
*__name__*: HttpProvider
|
|
|
|
*__description__*: The HTTP Provider allows sending requests using HTTP to a HTTP RPC server TCP port. It does not support subscriptions so you won't be able to listen to events such as new blocks or balance changes. It is usually preferrable using the [WsProvider](_ws_index_.wsprovider.md).
|
|
|
|
*__example__*:
|
|
```javascript
|
|
import Api from '@polkadot/api/promise';
|
|
import HttpProvider from '@polkadot/rpc-provider/http';
|
|
|
|
const provider = new HttpProvider('http://127.0.0.1:9933');
|
|
const api = new Api(provider);
|
|
```
|
|
|
|
*__see__*: [WsProvider](_ws_index_.wsprovider.md)
|
|
|
|
# Hierarchy
|
|
|
|
**HttpProvider**
|
|
|
|
# Implements
|
|
|
|
* `ProviderInterface`
|
|
|
|
# Constructors
|
|
|
|
<a id="constructor"></a>
|
|
|
|
## constructor
|
|
|
|
⊕ **new HttpProvider**(endpoint?: *`string`*): [HttpProvider](_http_index_.httpprovider.md)
|
|
|
|
*Defined in [http/index.ts:42](https://github.com/polkadot-js/api/blob/fb528d0/packages/rpc-provider/src/http/index.ts#L42)*
|
|
|
|
**Parameters:**
|
|
|
|
| Param | Type | Default value | Description |
|
|
| ------ | ------ | ------ | ------ |
|
|
| `Default value` endpoint | `string` | defaults.HTTP_URL | The endpoint url starting with http:// |
|
|
|
|
**Returns:** [HttpProvider](_http_index_.httpprovider.md)
|
|
|
|
___
|
|
|
|
# Methods
|
|
|
|
<a id="isconnected"></a>
|
|
|
|
## isConnected
|
|
|
|
▸ **isConnected**(): `boolean`
|
|
|
|
*Defined in [http/index.ts:59](https://github.com/polkadot-js/api/blob/fb528d0/packages/rpc-provider/src/http/index.ts#L59)*
|
|
|
|
*__summary__*: Whether the node is connected or not.
|
|
|
|
**Returns:** `boolean`
|
|
true if connected
|
|
|
|
___
|
|
<a id="on"></a>
|
|
|
|
## on
|
|
|
|
▸ **on**(type: *`ProviderInterface$Emitted`*, sub: *`ProviderInterface$EmitCb`*): `void`
|
|
|
|
*Defined in [http/index.ts:67](https://github.com/polkadot-js/api/blob/fb528d0/packages/rpc-provider/src/http/index.ts#L67)*
|
|
|
|
*__summary__*: Events are not supported with the HttpProvider, see [WsProvider](_ws_index_.wsprovider.md).
|
|
|
|
*__description__*: HTTP Provider does not have 'on' emitters. WebSockets should be used instead.
|
|
|
|
**Parameters:**
|
|
|
|
| Param | Type |
|
|
| ------ | ------ |
|
|
| type | `ProviderInterface$Emitted` |
|
|
| sub | `ProviderInterface$EmitCb` |
|
|
|
|
**Returns:** `void`
|
|
|
|
___
|
|
<a id="send"></a>
|
|
|
|
## send
|
|
|
|
▸ **send**(method: *`string`*, params: *`Array`<`any`>*): `Promise`<`any`>
|
|
|
|
*Defined in [http/index.ts:74](https://github.com/polkadot-js/api/blob/fb528d0/packages/rpc-provider/src/http/index.ts#L74)*
|
|
|
|
*__summary__*: Send HTTP POST Request with Body to configured HTTP Endpoint.
|
|
|
|
**Parameters:**
|
|
|
|
| Param | Type |
|
|
| ------ | ------ |
|
|
| method | `string` |
|
|
| params | `Array`<`any`> |
|
|
|
|
**Returns:** `Promise`<`any`>
|
|
|
|
___
|
|
<a id="subscribe"></a>
|
|
|
|
## subscribe
|
|
|
|
▸ **subscribe**(types: *`string`*, method: *`string`*, params: *`Array`<`any`>*, cb: *`ProviderInterface$Callback`*): `Promise`<`number`>
|
|
|
|
*Defined in [http/index.ts:96](https://github.com/polkadot-js/api/blob/fb528d0/packages/rpc-provider/src/http/index.ts#L96)*
|
|
|
|
*__summary__*: Subscriptions are not supported with the HttpProvider, see [WsProvider](_ws_index_.wsprovider.md).
|
|
|
|
**Parameters:**
|
|
|
|
| Param | Type |
|
|
| ------ | ------ |
|
|
| types | `string` |
|
|
| method | `string` |
|
|
| params | `Array`<`any`> |
|
|
| cb | `ProviderInterface$Callback` |
|
|
|
|
**Returns:** `Promise`<`number`>
|
|
|
|
___
|
|
<a id="unsubscribe"></a>
|
|
|
|
## unsubscribe
|
|
|
|
▸ **unsubscribe**(type: *`string`*, method: *`string`*, id: *`number`*): `Promise`<`boolean`>
|
|
|
|
*Defined in [http/index.ts:105](https://github.com/polkadot-js/api/blob/fb528d0/packages/rpc-provider/src/http/index.ts#L105)*
|
|
|
|
*__summary__*: Subscriptions are not supported with the HttpProvider, see [WsProvider](_ws_index_.wsprovider.md).
|
|
|
|
**Parameters:**
|
|
|
|
| Param | Type |
|
|
| ------ | ------ |
|
|
| type | `string` |
|
|
| method | `string` |
|
|
| id | `number` |
|
|
|
|
**Returns:** `Promise`<`boolean`>
|
|
|
|
___
|
|
|