@bitflowlabs/core-sdk 2.4.1 → 2.4.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +22 -2
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -4,7 +4,7 @@ Bitflow SDK is a powerful and easy-to-use library for interacting with the Bitfl
|
|
|
4
4
|
|
|
5
5
|
All Bitflow API endpoints are **publicly accessible without an API key**. Unauthenticated requests are subject to a default rate limit of **500 requests per minute per IP**.
|
|
6
6
|
|
|
7
|
-
If your integration requires higher limits,
|
|
7
|
+
If your integration requires higher limits, see the [Rate Limit Request](#rate-limit-request) section to email **help@bitflow.finance** with a pre-filled form. You can also reach the team on [Discord](https://discord.gg/DY4yNyHyhT).
|
|
8
8
|
|
|
9
9
|
# Table of Contents
|
|
10
10
|
|
|
@@ -21,6 +21,7 @@ If your integration requires higher limits, use the [rate limit request template
|
|
|
21
21
|
- [Executing Swap (uses `@stacks/connect`)](#executing-swap-uses-stacksconnect)
|
|
22
22
|
- [Types](#types)
|
|
23
23
|
- [Troubleshooting](#troubleshooting)
|
|
24
|
+
- [Rate Limit Request](#rate-limit-request)
|
|
24
25
|
- [License](#license)
|
|
25
26
|
|
|
26
27
|
# Installation
|
|
@@ -69,7 +70,7 @@ Create a `.env` file in your project root with the following variables:
|
|
|
69
70
|
```bash
|
|
70
71
|
# Bitflow Core API — publicly accessible, no key required
|
|
71
72
|
BITFLOW_API_HOST=https://bitflowsdk-api-test-7owjsmt8.uk.gateway.dev
|
|
72
|
-
# Optional: API key for higher rate limits (see
|
|
73
|
+
# Optional: API key for higher rate limits (see Rate Limit Request section below)
|
|
73
74
|
BITFLOW_API_KEY=<your_api_key_here>
|
|
74
75
|
|
|
75
76
|
# Your provider address
|
|
@@ -219,6 +220,25 @@ If you encounter any issues while using the Bitflow SDK, please check the follow
|
|
|
219
220
|
2. Make sure you have the latest version of the SDK installed.
|
|
220
221
|
3. Check that you're using a valid Stacks address for the senderAddress parameter.
|
|
221
222
|
|
|
223
|
+
# Rate Limit Request
|
|
224
|
+
|
|
225
|
+
If your integration needs more than **500 requests per minute per IP**, click the link below to open a pre-filled email in your mail client:
|
|
226
|
+
|
|
227
|
+
**[Request higher rate limits](mailto:help@bitflow.finance?subject=API%20Rate%20Limit%20Increase%20Request%20-%20%5BYour%20Project%20Name%5D&body=Hi%20Bitflow%20team%2C%0D%0A%0D%0AI%27m%20integrating%20the%20Bitflow%20SDK%20and%20would%20like%20to%20request%20an%20API%20key%20with%20increased%20rate%20limits.%0D%0A%0D%0AProject%20%2F%20Application%20name%3A%20%5Be.g.%20MyDeFi%20App%5D%0D%0ABrief%20description%3A%20%5BWhat%20your%20app%20does%20and%20how%20it%20uses%20the%20Bitflow%20API%5D%0D%0AWebsite%20%2F%20repo%20%28if%20public%29%3A%20%5BURL%20or%20N%2FA%5D%0D%0A%0D%0AAPIs%20I%20need%20higher%20limits%20for%20%28delete%20as%20applicable%29%3A%0D%0A-%20Bitflow%20Core%20API%20%28bitflow-sdk-api-gateway-7owjsmt8.uc.gateway.dev%29%0D%0A-%20Keeper%20API%20%28bitflow-keeper-7owjsmt8.uc.gateway.dev%29%0D%0A-%20Stacks%20Node%20%28node.bitflowapis.finance%29%0D%0A%0D%0AExpected%20request%20volume%3A%20%5Be.g.%20~2%2C000%20requests%2Fminute%20during%20peak%20hours%5D%0D%0A%0D%0AUse%20case%3A%20%5Be.g.%20Server-side%20data%20aggregation%2C%20real-time%20price%20feeds%20for%20N%20users%5D%0D%0A%0D%0AContact%20name%3A%20%5BYour%20name%5D%0D%0ADiscord%20handle%20%28optional%29%3A%20%5Be.g.%20%40yourhandle%5D%0D%0A%0D%0AThanks!)**
|
|
228
|
+
|
|
229
|
+
> If the link doesn't open your mail client, email **help@bitflow.finance** with the subject `API Rate Limit Increase Request` and include the following:
|
|
230
|
+
|
|
231
|
+
- **Project / Application name** — e.g. MyDeFi App
|
|
232
|
+
- **Brief description** — What your app does and how it uses the Bitflow API
|
|
233
|
+
- **Website / repo (if public)** — URL or N/A
|
|
234
|
+
- **APIs you need higher limits for** — Core API, Keeper API, Stacks Node (or all)
|
|
235
|
+
- **Expected request volume** — e.g. ~2,000 requests/minute during peak hours
|
|
236
|
+
- **Use case** — e.g. Server-side data aggregation, real-time price feeds for N users
|
|
237
|
+
- **Contact name**
|
|
238
|
+
- **Discord handle** (optional)
|
|
239
|
+
|
|
240
|
+
We aim to respond within 2 business days. For urgent requests, reach out on [Discord](https://discord.gg/DY4yNyHyhT).
|
|
241
|
+
|
|
222
242
|
# License
|
|
223
243
|
|
|
224
244
|
This project is licensed under the MIT License - see the LICENSE file for details.
|