Quickstart
This guide describes the process of integrating with Gateway’s Storage Layer directly, from initial setup to storage confirmation.
Integration Flow
1. Identity Creation
Encryption Keys
Generate a PRE-compatible key pair for encryption operations. For detailed instructions on key generation, see PRE Key Documentation.
Signing Keys
Generate secp256k1 signing keys for transaction authentication
2. File Assignment
Request a File ID from the Gateway Master Node using gRPC.
You must obtain an mTLS certificate from the Gateway team to network with our Storage Layer.
See Authentication Requirements to generate your certificate.
3. Chain Registration
Initialize the file record on the payment chain to establish ownership and permissions:
Contract information coming soon.
4. File Upload
Upload your file to the Gateway network using the assigned File ID:
Best Practices
- Implement retry logic for API calls
- Verify transaction confirmations
- Validate file integrity
- Monitor storage quotas
- Handle API rate limits
Security Considerations
- Secure API key management
- Client-side encryption before upload
- Checksum verification
- Transaction signature verification
- Regular permission audits
Error Handling
Common integration points requiring error handling:
-
API Errors
- Network connectivity issues
- Authentication failures
- Rate limiting
- Invalid requests
-
Chain Transaction Errors
- Transaction failures
- Invalid parameters
- Insufficient funds
- Permission errors