1Sat-Ordinals-Python-Inscriber

This project is a web application that allows users to inscribe data onto the Bitcoin SV (BSV) blockchain using Yours Wallet. The application supports the inscription of images and ensures all inscriptions are valid according to 1Sat Ordinals standards.

Features

Log in with Yours Wallet.
Inscribe images onto the BSV blockchain.
Validate inscriptions to ensure they meet the 1Sat Ordinals requirements.

Prerequisites

Python 3.7+
Yours Wallet extension installed in your browser (Download Yours Wallet)

Setup

Step 1: Clone the Repository

git clone https://github.com/ishalliveforever/1Sat-Ordinals-Python-Inscriber.git
cd 1Sat-Ordinals-Python-Inscriber

Step 2: Create and Activate a Virtual Environment

python -m venv venv
source venv/bin/activate  # On Windows use `venv\Scripts\activate`

Step 3: Install Dependencies

pip install -r requirements.txt

Step 4: Run the Application

python app.py

The application will run on http://127.0.0.1:5000.

Project Structure

/your-project-directory
    /static
        wallet_inscription.html
    app.py
    requirements.txt
    README.md

Usage

Logging in with Panda Wallet

Open your browser and navigate to http://127.0.0.1:5000.
Click on the "Log in with Yours Wallet" button.
Follow the prompts to connect your Panda Wallet.

Inscribing an Image

Once logged in, fill out the form:
- Image to Inscribe: Select the image you want to inscribe.
- MIME Type: The MIME type of the image (default is image/png).
- App Name: The name of your application.
- Data Name: A name for the data being inscribed.
- Destination Address: The BSV address where the inscription will be sent.
Click "Inscribe".
Wait for the transaction to be processed. You will receive a notification with the transaction ID if the inscription is successful.

Validating Inscriptions

The inscriptions created by this application follow the 1Sat Ordinals standard, ensuring they are valid and meet the necessary requirements.

Troubleshooting

Common Issues

Panda Wallet is not ready: Ensure you have the Panda Wallet extension installed and set up in your browser.
No UTXOs found for the address: Ensure your wallet has unspent transaction outputs (UTXOs) to use for the inscription.

Logs

Check the console logs in your browser and the terminal running the Flask app for detailed error messages and debugging information.

Contributing

Contributions are welcome! Please fork the repository and submit a pull request with your changes.

ishalliveforever/1Sat-Ordinals-Python-Inscriber