# Resonance — Open-Loop Loyalty Infrastructure

> Resonance is a loyalty network that brands plug into. You define what actions earn credits, and your customers earn those credits by participating — across Discord, Telegram, Slack, your website, your app, or anywhere you integrate. Credits are spendable on perks offered by any brand in the network.

## Key Facts

- Token: RSNC (on Soneium mainnet)
- Zero blockchain complexity — users don't need wallets or crypto knowledge
- Gasless transactions — all blockchain fees covered
- Open-loop — credits earned on any platform are spendable across the entire network
- 45 MCP tools across 17 modules for AI-powered loyalty management

## Quick Start

- Partner Portal: https://partners.rsnc.network
- Event Handler API: https://api.rsnc.network/resonance-api/manual-event
- Reward Agent: https://agent.rsnc.network
- MCP Server: https://agent.rsnc.network/mcp
- Perks Marketplace: https://perks.rsnc.network
- OpenAPI Spec: https://docs.rsnc.network/openapi.yaml

## Documentation Map

- Homepage: https://docs.rsnc.network
- Quick Start: https://docs.rsnc.network/quickstart
- Architecture: https://docs.rsnc.network/architecture
- Choose Integration: https://docs.rsnc.network/getting-started/choose-integration
- Platform Roadmap: https://docs.rsnc.network/getting-started/platform-roadmap

## Integrations

### Discord Bot (Production)
Full-featured community loyalty bot with 70+ slash commands.
- Setup: https://docs.rsnc.network/discord/setup
- Commands: https://docs.rsnc.network/discord/admin-guides/commands-reference
- Configuration: https://docs.rsnc.network/discord/admin-guides/configuration

### Telegram Bot (Production)
Community loyalty bot with core parity to Discord.
- Setup: https://docs.rsnc.network/telegram/setup
- Commands: https://docs.rsnc.network/telegram/admin-guides/commands-reference

### Slack Integration (Production)
Workspace loyalty bot for team engagement.
- Overview: https://docs.rsnc.network/slack/overview
- Setup: https://docs.rsnc.network/slack/setup

### Custom HTTP Integration (Production)
Any platform that makes HTTP POST requests can integrate.
- Overview: https://docs.rsnc.network/platform-developers/overview
- Authentication: https://docs.rsnc.network/platform-developers/authentication
- Examples: https://docs.rsnc.network/platform-developers/examples

### Shopify App (Production)
E-commerce purchase and referral rewards.
- Overview: https://docs.rsnc.network/shopify/overview
- Setup: https://docs.rsnc.network/shopify/setup

### Reward Agent (Production)
45 MCP tools across 17 modules for AI-powered loyalty.
- Overview: https://docs.rsnc.network/agent/overview
- REST API: https://docs.rsnc.network/agent/rest-api
- CLI: https://docs.rsnc.network/agent/cli
- Converse: https://docs.rsnc.network/agent/converse
- Tools Reference: https://docs.rsnc.network/agent/tools-reference

## API Reference

- Event Handler: https://docs.rsnc.network/api/event-handler
- Gas Relayer: https://docs.rsnc.network/api/gas-relayer
- Perk Charges: https://docs.rsnc.network/api/perk-charges
- Pregeneration: https://docs.rsnc.network/api/pregeneration
- Error Codes: https://docs.rsnc.network/api/error-codes

## Authentication

- HMAC-SHA256 signature (server-to-server)
- String-to-sign: `timestamp\nmethod\npath\nSHA256(body)`
- Headers: X-Resonance-Brand-Id, X-Resonance-Signature, X-Resonance-Timestamp

## Smart Contracts (Soneium Mainnet)

- RSNC Token: 0x4183CD8fE04bA0f10Ca83cf9E76e58ef8dB7cb33
- PerkNFT: 0x997f05E7447Fdde75d47eBb12D4D6C65013AA0Da
- PointsSale: 0x02939031C36637a4c46d86832D7015a2F350cc7D

## Support

- Discord: https://discord.gg/rsnc-network
- Email: support@rsnc.network
- Developers: developers@rsnc.network

## Optional

- Full tools reference: https://docs.rsnc.network/llms-full.txt
- OpenAPI specification: https://docs.rsnc.network/openapi.yaml