CREATED BY AWS Authored by: Simon Goldberg (AWS)
Overview
This project demonstrates workflows using the Chainlink Runtime Environment to fetch data from AWS serverless APIs and write results to Ethereum smart contracts.
The system combines AWS reliability with decentralized trust guarantees to support digital asset price feeds and proof-of-reserves monitoring.
Architecture
Use Cases
- Price feeds for DeFi protocols: Low-latency, tamper-resistant pricing data for lending, derivatives, and AMMs with decentralized verification.
- Proof-of-reserves monitoring: Continuous verification that stablecoins and wrapped assets are fully backed by underlying reserves.
- Custom data feeds: Configurable, multi-source data feeds for tokenized assets.
Components
- AWS Serverless Backend - REST API with Lambda and DynamoDB for oracle data storage (Setup Guide)
- CRE Workflows - Go-based workflow for data fetching and contract updates (Setup Guide)
- Smart Contracts - PriceFeed and CollateralizationMonitor contracts on Ethereum Sepolia (Contract Guide)
Prerequisites
- AWS CLI - Configured with credentials (Installation)
- AWS SAM CLI - For serverless deployment (Installation)
- CRE CLI - v1.0.3+ (Installation)
- After installation, authenticate with
cre login - Verify authentication with
cre whoami
- After installation, authenticate with
- Node.js - 20+ for AWS Lambda functions
- Go - 1.25.3+ for CRE workflows
- Sepolia ETH - For contract deployment and transactions (Get testnet ETH at a public faucet)
Quick Start
Automated Deployment (Recommended)
Clone the repository and deploy everything with a single script:
git clone https://github.com/aws-samples/sample-cre-pricefeeds-por.git
cd sample-cre-pricefeeds-por
./deploy-all.sh
This automates:
- AWS infrastructure deployment (Lambda, API Gateway, DynamoDB)
- Smart contract deployment to Sepolia
- CRE workflow configuration and testing
See the below for details and deeper dives.
Manual Deployment
1 Deploy AWS Backend
Deploy the serverless REST API with Lambda and DynamoDB. See AWS Backend README for complete setup instructions.
2 Setup and Run CRE Workflow
Configure and run the CRE workflow to fetch data from AWS and update smart contracts on Ethereum Sepolia. See CRE Workflow README for complete setup instructions, including smart contract deployment and configuration.
Documentation
Technology Stack
- Chainlink CRE - v1.0.3 (Workflow orchestration)
- AWS SAM - Infrastructure as Code
- Amazon API Gateway - Managed API service for HTTP/REST endpoints Lambda integation and authorization
- AWS Lambda - Serverless compute
- AWS DynamoDB - NoSQL database
- Solidity - Smart contracts
- Foundry - Contract development
- Go - Workflow implementation
Security
See CONTRIBUTING for more information.
License
This library is licensed under the MIT-0 License. See the LICENSE file.