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