Skip to content

About

AWS and Chainlink Runtime Environment (CRE) sample for delivering digital-asset price feeds and proof-of-reserves data to Ethereum smart contracts using serverless APIs.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Latest commit

 

History

17 Commits

Folders and files

Repository files navigation

Digital Asset Price Feeds & Proof of Reserves (PoR): Integrating AWS with Chainlink Runtime Environment (CRE) Workflows

Authored by: Simon Goldberg

This sample is part of the AWS Digital Asset Samples collection.

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

Architecture Diagram

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
  • 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)

Windows Users: This sample uses Bash scripts and Unix tools. Please run deployments using WSL2.

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.

Note: CRE is also available in TypeScript. For TypeScript implementation details, refer to the CRE documentation.

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.

About

AWS and Chainlink Runtime Environment (CRE) sample for delivering digital-asset price feeds and proof-of-reserves data to Ethereum smart contracts using serverless APIs.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages