# Synor Developer Tutorials

Welcome to the Synor tutorial series! These step-by-step guides will teach you to build on the first post-quantum secure blockchain.

## Tutorial Series

### 1. [Getting Started](./01-getting-started.md)
Set up your development environment, create a wallet, and send your first transaction.

**You'll learn:**
- Running a local Synor node
- Creating wallets and addresses
- Sending and receiving SYNOR
- Understanding hybrid signatures

### 2. [Building a Wallet Application](./02-building-a-wallet.md)
Build a complete React wallet application from scratch.

**You'll learn:**
- React + TypeScript setup
- BIP-39 mnemonic handling
- Encrypted wallet storage
- Balance display and QR codes
- Transaction history

### 3. [Smart Contracts on Synor](./03-smart-contracts.md)
Write, deploy, and interact with WebAssembly smart contracts.

**You'll learn:**
- Rust contract development
- Contract state management
- Events and logging
- Token contract example
- Testing and deployment

### 4. [Working with the API](./04-api-guide.md)
Master the Synor JSON-RPC and WebSocket APIs.

**You'll learn:**
- Query blockchain data
- Real-time subscriptions
- Transaction building
- Error handling
- Building API clients

---

## Quick Links

| Resource | Description |
|----------|-------------|
| [Developer Guide](../DEVELOPER_GUIDE.md) | Complete developer reference |
| [API Reference](../API_REFERENCE.md) | Full RPC documentation |
| [Exchange Integration](../EXCHANGE_INTEGRATION.md) | For exchanges |
| [Host Functions](../../contracts/HOST_FUNCTIONS.md) | Contract host API |

---

## Prerequisites

Before starting, ensure you have:

- **Docker & Docker Compose** - For running nodes
- **Node.js 18+** - For JavaScript/TypeScript examples
- **Rust 1.70+** - For contract development
- **Git** - For cloning repositories

---

## Getting Help

- **GitHub Issues:** [github.com/synor/synor/issues](https://github.com/synor/synor/issues)
- **Discord:** [discord.gg/synor](https://discord.gg/synor)
- **Documentation:** [docs.synor.cc](https://docs.synor.cc)

---

## Contributing

Found an issue or want to improve a tutorial? We welcome contributions!

1. Fork the repository
2. Make your changes
3. Submit a pull request

---

*Happy building on Synor!*
