forked from Qortal/Q-Manager
Update README.md
This commit is contained in:
parent
2260222544
commit
6cc918c25a
85
README.md
85
README.md
@ -1,86 +1 @@
|
|||||||
# Q-Sandbox
|
|
||||||
|
|
||||||
**Q-Sandbox** is a developer-focused repository designed to help you explore and experiment with various `qortalRequests` for [Qortal](https://qortal.dev). This sandbox environment allows you to become familiar with the Qortal API, providing a practical space to test and understand its capabilities.
|
|
||||||
|
|
||||||
## 🚀 Features
|
|
||||||
|
|
||||||
- Test a wide range of `qortalRequests`.
|
|
||||||
- Experiment in a controlled environment without needing to build your own Q-App.
|
|
||||||
- Learn the Qortal API in a hands-on way.
|
|
||||||
- Build confidence and skills for developing on the Qortal ecosystem.
|
|
||||||
|
|
||||||
## 📚 Getting Started
|
|
||||||
|
|
||||||
1. **Clone the Repository**:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
git clone https://github.com/JustinReact/q-sandbox.git
|
|
||||||
cd q-sandbox
|
|
||||||
```
|
|
||||||
|
|
||||||
2. **Install Dependencies**:
|
|
||||||
Ensure you have all necessary dependencies installed:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
npm install
|
|
||||||
```
|
|
||||||
|
|
||||||
3. **Run the Sandbox**:
|
|
||||||
Start the sandbox environment:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
npm run dev
|
|
||||||
```
|
|
||||||
|
|
||||||
4. **Access the Qortal API**:
|
|
||||||
Open the project in your preferred editor, and explore preconfigured API requests in the `src/qortalRequests` directory.
|
|
||||||
|
|
||||||
## 📖 How to Use
|
|
||||||
|
|
||||||
1. Navigate to the `App.jsx` file to find examples of different API requests.
|
|
||||||
2. Customize these requests to fit your use case or create new ones to explore the full power of the Qortal API.
|
|
||||||
3. View responses and debug in real time using the Chrome dev console or Qortal Hub console.
|
|
||||||
|
|
||||||
## 🛠 Requirements
|
|
||||||
|
|
||||||
- **Qortal Node**: A running Qortal node is required for API requests to work, unless you are using a gateway node.
|
|
||||||
|
|
||||||
## 💡 Examples
|
|
||||||
|
|
||||||
Here are a few examples of what you can do in Q-Sandbox:
|
|
||||||
|
|
||||||
1. Fetch user account details:
|
|
||||||
|
|
||||||
```javascript
|
|
||||||
let account = await qortalRequest({
|
|
||||||
action: "GET_USER_ACCOUNT",
|
|
||||||
});
|
|
||||||
```
|
|
||||||
|
|
||||||
2. Join a group:
|
|
||||||
|
|
||||||
```javascript
|
|
||||||
const response = await qortalRequest({
|
|
||||||
action: "JOIN_GROUP",
|
|
||||||
groupId: groupId,
|
|
||||||
});
|
|
||||||
```
|
|
||||||
|
|
||||||
3. Send QORT coin:
|
|
||||||
```javascript
|
|
||||||
const response = await qortalRequest({
|
|
||||||
action: "SEND_COIN",
|
|
||||||
coin: "QORT",
|
|
||||||
destinationAddress: destinationAddress,
|
|
||||||
amount: amount, // 1 LTC
|
|
||||||
fee: 20, // 0.00000020 LTC per byte
|
|
||||||
});
|
|
||||||
```
|
|
||||||
|
|
||||||
## 🤝 Contributing
|
|
||||||
|
|
||||||
Contributions are welcome! If you have ideas for improving the sandbox or additional `qortalRequests` you'd like to see, feel free to open an issue or submit a pull request.
|
|
||||||
|
|
||||||
## 🧾 License
|
|
||||||
|
|
||||||
This repository is open-source.
|
|
||||||
|
Loading…
x
Reference in New Issue
Block a user