Skip to content

Commit

Permalink
Added installation guide and completed milestone 2
Browse files Browse the repository at this point in the history
  • Loading branch information
sukunetsiz committed Jan 12, 2025
1 parent 00a2bdd commit 88e9dc2
Show file tree
Hide file tree
Showing 5 changed files with 95 additions and 9 deletions.
2 changes: 0 additions & 2 deletions .env.example
Original file line number Diff line number Diff line change
Expand Up @@ -48,8 +48,6 @@ VITE_APP_NAME="${APP_NAME}"
MONERO_RPC_HOST=127.0.0.1
MONERO_RPC_PORT=18082
MONERO_RPC_SSL=false
MONERO_RPC_USERNAME=your_username
MONERO_RPC_PASSWORD=your_password
MONERO_VENDOR_PAYMENT_REQUIRED_AMOUNT=0.4
MONERO_VENDOR_PAYMENT_MINIMUM_AMOUNT=0.04
MONERO_ADDRESS_EXPIRATION_TIME=1440
Expand Down
6 changes: 2 additions & 4 deletions app/Http/Controllers/BecomeVendorController.php
Original file line number Diff line number Diff line change
Expand Up @@ -25,9 +25,7 @@ public function __construct()
$this->walletRPC = new walletRPC(
$config['host'],
$config['port'],
$config['ssl'],
$config['username'],
$config['password']
$config['ssl']
);
} catch (\Exception $e) {
Log::error('Failed to initialize Monero RPC connection: ' . $e->getMessage());
Expand Down Expand Up @@ -175,4 +173,4 @@ private function generateQrCode($address)
return null;
}
}
}
}
2 changes: 0 additions & 2 deletions config/monero.php
Original file line number Diff line number Diff line change
Expand Up @@ -4,8 +4,6 @@
'host' => env('MONERO_RPC_HOST', '127.0.0.1'),
'port' => env('MONERO_RPC_PORT', 18082),
'ssl' => env('MONERO_RPC_SSL', false),
'username' => env('MONERO_RPC_USERNAME', 'monero'),
'password' => env('MONERO_RPC_PASSWORD', 'jpcgaotjx3vJWm0+1mElVA=='),
'vendor_payment_required_amount' => env('MONERO_VENDOR_PAYMENT_REQUIRED_AMOUNT', 0.4),
'vendor_payment_minimum_amount' => env('MONERO_VENDOR_PAYMENT_MINIMUM_AMOUNT', 0.04),
'address_expiration_time' => env('MONERO_ADDRESS_EXPIRATION_TIME', 1440),
Expand Down
92 changes: 92 additions & 0 deletions docs/CONNECTING-MONERO-RPC.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,92 @@
## Connecting Monero Wallet RPC to Kabus Marketplace

This guide will walk you through connecting a Monero wallet RPC to your Kabus marketplace installation.

## Prerequisites
Before we begin, ensure you're in your Downloads folder where we'll store the Monero CLI tools:
```bash
cd Downloads
```

## Downloading and Extracting Monero CLI
First, let's download the Monero CLI package:
```bash
wget https://downloads.getmonero.org/cli/linux64
```

Extract the downloaded package:
```bash
bunzip2 linux64
tar xvf linux64.out
```

Navigate to the extracted directory (your version number might differ):
```bash
cd monero-x86_64-linux-gnu-v0.18.3.4
```

## Creating Your Marketplace Wallet
Now we'll create a dedicated wallet for your marketplace:
```bash
./monero-wallet-cli
```

When prompted:
1. Enter "kabus-wallet" as your wallet name
2. Type "Y" to confirm
3. Password is optional - press Enter to skip
4. Select language by typing "1" for English
5. **Important**: Securely store the 25-word seed phrase that appears
6. Choose whether to enable background mining (type "Yes" or "No")

To exit the wallet CLI, press CTRL+C.

## Connecting to a Monero Node
You have two options for connecting to the Monero network:
- Set up your own node (better privacy but requires more time and storage)
- Connect to a remote node (faster setup but less private)

For this guide, we'll use a remote node. You can find trusted remote nodes at [xmr.ditatompel.com/remote-nodes/](https://xmr.ditatompel.com/remote-nodes/).

First, let's get your wallet's exact location:
```bash
realpath kabus-wallet
```

## Starting the Wallet RPC Server
Use the following command to start the RPC server (replace the wallet-file location with your actual path):
```bash
./monero-wallet-rpc \
--rpc-bind-port 18082 \
--daemon-host xmr.surveillance.monster:443 \
--confirm-external-bind \
--wallet-file /root/Downloads/monero-x86_64-linux-gnu-v0.18.3.4/kabus-wallet \
--prompt-for-password \
--trusted-daemon \
--daemon-ssl-allow-any-cert \
--log-file logs/monero-wallet-rpc.log \
--log-level 1 \
--disable-rpc-login
```

## Optional: Using Screen Sessions
If you're using a CLI-based system, you can run the wallet RPC in a screen session:

Create a new screen session:
```bash
screen -S kabus_session
```

Run the wallet RPC command in this session, then detach by pressing CTRL+A+D.

To reattach to the session later:
```bash
screen -r kabus_session
```

## Important Notes
- Never share your wallet's seed phrase with anyone
- Always properly close the wallet RPC using CTRL+C when needed
- Consider using Tor or I2P networks for enhanced privacy when connecting to remote nodes

Your Monero wallet RPC should now be properly configured and ready to use with your Kabus marketplace installation.
2 changes: 1 addition & 1 deletion docs/ROADMAP.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ On January 1st, I created the Kabus Marketplace Script repository, marking the b

### February 2nd Goals (v0.8)
- [X] Make the referral system optional during user registration instead of mandatory.
- [ ] Write clear and comprehensible documentation for Kabus Marketplace Script.
- [X] Write clear and comprehensible documentation for Kabus Marketplace Script.
- [ ] Develop a shopping cart system and enable adding products to the cart.
- [ ] Write a comprehensive "How to Buy Monero" guide.

Expand Down

0 comments on commit 88e9dc2

Please # to comment.