Skip to content

Security: AtomicIP/AtomicIP-

Security

SECURITY.md

Security Policy

Overview

The AtomicIP project handles real XLM and intellectual property assets through Soroban smart contracts. Security is critical to protect users' funds and IP rights.

Reporting a Vulnerability

We take security vulnerabilities seriously. If you discover a security vulnerability, please follow responsible disclosure practices.

How to Report

DO NOT open a public GitHub issue for security vulnerabilities.

Instead, please report vulnerabilities via one of the following methods:

  1. Email: Send a detailed report to security@atomicip.io
  2. GitHub Security Advisories: Use the Security Advisories page

What to Include

When reporting a vulnerability, please include:

  • Description of the vulnerability
  • Steps to reproduce the issue
  • Potential impact assessment
  • Suggested fix (if available)
  • Any relevant logs or screenshots

Response Timeline

  • Initial Response: Within 48 hours of receipt
  • Status Update: Within 7 days
  • Fix Timeline: Depends on severity, typically 14-30 days

Disclosure Process

  1. Acknowledgment: We will acknowledge receipt of your report within 48 hours
  2. Investigation: Our team will investigate and validate the vulnerability
  3. Fix Development: We will develop and test a fix
  4. Disclosure: We will coordinate disclosure with you after the fix is deployed
  5. Credit: We will credit you in the security advisory (unless you prefer anonymity)

Security Best Practices for Users

For IP Owners

  • Keep your secret safe: The secret used to create your commitment hash is the only way to prove ownership. Store it securely offline.
  • Verify commitment hashes: Before committing, verify your commitment hash is correctly computed: sha256(secret || blinding_factor)
  • Use strong secrets: Use cryptographically secure random values for secrets and blinding factors
  • Backup your keys: Maintain secure backups of your Stellar wallet keys

For Swap Participants

  • Verify swap details: Always verify the IP ID, price, and counterparty before accepting a swap
  • Check expiry times: Be aware of swap expiry times to avoid losing funds
  • Use trusted registries: Only interact with verified IP registry contracts
  • Monitor transactions: Review transaction details before signing

Known Limitations

Current Limitations

  1. No Token Escrow: The current implementation does not escrow tokens during swaps. Payment is transferred to the contract but not held in escrow. This will be addressed in v1.1.

  2. Single Network: Currently only supports Stellar testnet. Mainnet support is planned for v1.0.

  3. No Partial Disclosure: The commitment scheme requires full secret revelation. Partial disclosure proofs are planned for v2.0.

  4. Gas Costs: Complex operations may have higher gas costs. Optimization is ongoing.

  5. Frontend Not Included: The current repository contains only smart contracts. A frontend UI is planned for v3.0.

Security Assumptions

  • Users maintain secure storage of their secrets and private keys
  • The Stellar network operates as expected
  • Soroban runtime is secure and bug-free
  • Cryptographic primitives (SHA256) are secure

Security Features

Implemented

  • ✅ Pedersen commitment scheme for IP privacy
  • ✅ Atomic swap with key verification
  • ✅ Authorization checks via require_auth()
  • ✅ Duplicate commitment prevention
  • ✅ Expiry-based cancellation for buyers
  • ✅ Monotonic ID generation (upgrade-safe)

Planned

  • 🔄 Token escrow in atomic swaps
  • 🔄 Multi-signature support
  • 🔄 Time-locked commitments
  • 🔄 Partial disclosure proofs

Security Audits

Audit Status

  • Initial Review: Internal security review completed
  • External Audit: Planned for Q2 2026
  • Bug Bounty: Planned for post-mainnet launch

Audit Reports

Audit reports will be published in the security-advisories section after completion.

Contact

For security-related inquiries:

Bug Bounty Program (Planned)

We plan to launch a bug bounty program after mainnet launch. Rewards will be based on severity:

  • Critical: $5,000 - $25,000
  • High: $1,000 - $5,000
  • Medium: $500 - $1,000
  • Low: $100 - $500

Details will be published at bugbounty.atomicip.io when the program launches.

Legal

This security policy is subject to our Terms of Service and Privacy Policy.


Last Updated: 2026-03-27 Version: 1.0.0

There aren’t any published security advisories