> ## Documentation Index
> Fetch the complete documentation index at: https://docs.repstation.xyz/llms.txt
> Use this file to discover all available pages before exploring further.
# IOTA Repstation SDK
> A production-ready TypeScript SDK for decentralized reputation management on IOTA
## What is IOTA Repstation?
IOTA Repstation is a **deal-bound, app-scoped reputation system** built on IOTA's MoveVM that enables applications to create and manage transparent, portable reputation scores for their users.
Ratings are tied to specific transactions/deals, ensuring authentic feedback from real interactions.
Users' reputation follows them across all platforms using the SDK, building long-term trust.
Each application maintains its own reputation namespace while contributing to global scores.
Full TypeScript support with generated types for a seamless developer experience.
## Quick Start
Get started with IOTA Repstation in just a few lines of code:
```javascript Browser/Frontend theme={null}
import { RepstationClient, IotaClient } from '@repstation/sdk';
// Optional: create IOTA client for real blockchain interactions
const iotaClient = new IotaClient({
url: 'https://api.testnet.iota.cafe'
});
// Create client using factory method (recommended)
const client = await RepstationClient.create({
network: 'testnet',
rpcUrl: 'https://api.testnet.iota.cafe',
client: iotaClient // Optional
});
// Get a user's reputation
const result = await client.getReputationProfile({
walletAddress: '0xUSER_WALLET'
});
if (result.success) {
console.log(`Reputation: ${result.profile?.global?.average}/100`);
}
```
```javascript Server/Backend theme={null}
import { RepstationClient, IotaClient } from '@repstation/sdk';
// Create IOTA client for server operations
const iotaClient = new IotaClient({
url: 'https://api.testnet.iota.cafe'
});
// Create client using factory method
const client = await RepstationClient.create({
network: 'testnet',
client: iotaClient
// SDK automatically loads contract addresses from configuration
});
// Register your platform (returns Transaction for signing)
const registerTx = client.registerApp({
providerMetadata: {
providerName: 'My Platform',
publicUrl: 'https://myplatform.com',
xHandle: '@myplatform'
}
});
// Sign and execute transaction with your wallet/signer
```
Follow our quickstart guide to integrate reputation into your platform in minutes.
## Key Features
All ratings and reputation scores are stored on the IOTA blockchain, providing complete transparency and immutability. Users can verify their reputation across platforms.
Build a network effect where users' reputation grows across all integrated platforms. A user's good behavior on one marketplace benefits them on all others.
Simple SDK with comprehensive examples for common use cases like NFT marketplaces, service platforms, and DeFi protocols.
Built on IOTA's secure MoveVM with capability-based security ensuring only authorized parties can perform actions.
## Use Cases
IOTA Repstation is perfect for any platform where trust between parties matters:
Build trust between buyers and sellers with deal-based ratings after each transaction.
Rate service providers and clients based on completed work and payment history.
Build automated credit scoring for DeFi lending using blockchain reputation data.
## Architecture Overview
When users engage in a transaction, your platform creates a **Deal** that represents the agreement between parties.
Parties accept and complete the deal through your platform's normal flow (payment, delivery, etc.).
After completion, both parties can rate each other, contributing to their **global** and **app-specific** reputation scores.
Users' reputation follows them to other platforms using the same SDK, creating network effects.
## Ready to Build?
Install the SDK and set up your first integration.
Explore the complete SDK API documentation.
See real-world examples of platform integrations.
Understand deals, ratings, and reputation aggregation.
IOTA Repstation is currently in beta. The SDK is production-ready but the smart contract addresses may change. Join our community for updates and support.