SORA

SORA is a cross platform, electron based application designed to streamline the use of the Soroban CLI. It offers a user-friendly interface for managing projects, identities, networks, and contract methods with ease.

You can watch the how-to-use demo here.

For detailed instructions on each feature, please refer to our comprehensive documentation.

Installation

To use this application, you must have soroban-cli installed on your operating system.

This application is compatible with latest soroban v0.23.1, please make sure you have installed this version or newer of soroban!

• To install soroban, follow the instructions in link below:

  • Install Soroban

• To verify that soroban properly installed, run: soroban --version

Now that you have soroban installed, you can install the SORA by following the instructions below.

 macOS (Apple Silicon | Intel)

1. Download the latest release for macOS
   1. Apple Silicon
   2. Intel
2. Open the downloaded file and drag the Sora to the Applications directory.

🐧 Linux

1. Download the latest release for Linux

   1. App Image
   2. Snap

2. Follow the general instructions to install the application on your Linux distribution.

   1. App Image
   2. Snap

💻 Windows (Through WSL 2)

You can still use the SORA application on Windows by following the instructions below.

1. Install WSL 2 by following the instructions on microsoft docs.
2. Once you have WSL installed, you can install soroban-cli by following the instructions for Linux.
3. Follow the instructions for Linux to install the SORA.

🔹 Stellar Suite (Vs Code Extension)

You can install the extension on Visual Studio Marketplace

---

Key Features

• Project Management: Create, import, and manage Soroban projects with ease.
• Identity Management: Generate, add, and manage Soroban identities.
• Contract Interactions: Intuitive interface for interacting with Soroban contracts.
• Network Management: Add, remove, and manage Soroban networks.
• Event Monitoring: Track and filter Soroban contract events in real-time.
• Experimental Lab: Explore Soroban's cutting-edge features and tools.
• AI-Powered Command Constructor: Generate Soroban CLI commands using natural language.
• Soroban AI Assistant: Get instant support for Soroban development queries.
• VS Code Extension: Seamlessly integrate Sora functionality into your VS Code workflow.

P.S: Review the latest release notes for more information about the features and capabilities of the SORA application.

Development

Quick Start

# Clone the repository
git clone https://github.com/tolgayayci/sora.git
cd sora

# Install dependencies
npm install

# Start development server
npm run dev

Building

# Build for current platform
npm run build

# Build for all platforms
npm run build:all

# Build for specific platform
npm run build:platform linux

Testing

# Run all tests
npm run test

# Run tests with coverage
npm run test:coverage

# Run linting
npm run lint

Deployment

# Deploy locally
npm run deploy:local

# Deploy to GitHub
npm run deploy:github

# Create release
npm run deploy:release

For detailed build and deployment instructions, see our Build & Deploy Guide.

Contributing

We welcome contributions! To contribute:

1. Fork the repository
2. Create a new branch
3. Make your changes
4. Run tests: npm run test
5. Submit a pull request with a description of your changes

For feature requests or bug reports, please use our issue templates:

• Feature Request Template
• Bug Report Template

License

SORA is released under the MIT. See (LICENSE) for more details.