Chainlink Functions란?
Chainlink Functions는 스마트 컨트랙트에 신뢰할 수 있는 컴퓨팅 인프라 액세스를 제공합니다. 스마트 컨트랙트는 코드를 분산된 오라클 네트워크(DON)로 전송하고, 각 DON의 오라클은 동일한 코드를 서버리스 환경에서 실행합니다. DON은 독립적으로 실행된 결과를 집계하고 최종 결과를 스마트 컨트랙트에 반환합니다. 코드는 간단한 계산부터 API 공급자로부터 데이터를 가져오는 등 다양한 작업을 수행할 수 있습니다.
Chainlink Functions는 자체 Chainlink 노드를 실행하고 구성할 필요 없이 오프체인 컴퓨팅에 액세스할 수 있는 방법을 제공합니다. 요청을 지불하기 위해 LINK로 구독 계정을 자금화합니다. 구독은 DON이 요청을 충족할 때에만 청구됩니다.
Chainlink Functions 사용 예시
참고: 주의사항
Chainlink Functions는 자체 서비스 솔루션이며, 작성하고 제출하는 모든 JavaScript 코드를 독립적으로 검토해야 합니다.
이는 Chainlink Functions에서 실행되는 API 종속성을 포함합니다.
커뮤니티에서 만든 JavaScript 코드 예제는 검토되지 않을 수 있으므로
사용하기 전에 코드를 독립적으로 검토해야 합니다.
Chainlink Functions는 "있는 그대로" 제공되며 어떠한 종류의 조건이나 보증 없이 "있는 그대로" 제공됩니다.
Chainlink Labs, Chainlink Foundation, Chainlink 노드 운영자는 개발자가 제출한 JavaScript 코드의 오류나 API 종속성 문제로 인해 발생하는 의도하지 않은 결과에 대해 책임지지 않습니다.
사용자는 요청에서 지정한 데이터 소스가 충분한 품질을 갖고 필요한 가용성을 가지고 있는지 확인해야 합니다.
사용자는 Chainlink Functions를 통해 연결하는 모든 데이터 제공자의 라이선스 계약을 준수하는 책임이 있습니다.
Chainlink Functions는 다양한 사용 사례를 지원합니다. Chainlink Functions를 사용하여 다음과 같은 작업을 수행할 수 있습니다:
-
어떤 공개 데이터에도 연결할 수 있습니다. 예를 들어, 기상 통계를 연결하여 파라메트릭 보험을 위한 정보를 얻거나, 실시간 스포츠 결과를 연결하여 동적 NFT에 활용할 수 있습니다.
-
공개 데이터를 연결하고 소비하기 전에 변형할 수 있습니다. Twitter API에서 데이터를 읽어와 트위터 감성을 계산하거나, Chainlink Price Feeds의 가격 데이터를 읽어 자산 가격을 유도할 수 있습니다.
-
비밀번호로 보호된 데이터 소스에 연결할 수 있습니다. 스마트워치와 같은 IoT 기기부터 기업 자원 계획 시스템까지 다양한 데이터 소스에 접근할 수 있습니다.
-
IPFS와 같은 외부 탈중앙화된 데이터베이스에 연결하여 dApp의 오프체인 프로세스를 용이하게 하거나 저비용의 거버넌스 투표 시스템을 구축할 수 있습니다.
-
기존의 Web2 애플리케이션에 연결하여 복잡한 하이브리드 스마트 컨트랙트를 구축할 수 있습니다.
-
AWS S3, Firebase, Google Cloud Storage와 같은 거의 모든 Web2 시스템에서 데이터를 가져올 수 있습니다.
이러한 기능을 통해 Chainlink Functions는 다양한 데이터 소스와 상호작용하여 스마트 컨트랙트를 더욱 강력하고 유연하게 만들어줍니다.
작성일 기준으로는 테스트넷에서만 사용가능합니다.
참고: 테스트넷 베타 미리보기
Chainlink Functions는 개발자들을 위해 강건하고 안전한 플랫폼을 보장하기 위해 한정된 베타 미리보기로 테스트넷에서만 사용할 수 있습니다. 베타 단계에서는 제품화된 애플리케이션에 사용하거나 가치있는 자산을 보호하는 데에는 사용하지 않도록 개발자들은 최상의 실천 방법을 따라야 합니다. Chainlink Functions는 계속 발전하고 개선될 것으로 예상됩니다. 베타 서비스 도중에는 중요한 변경 사항이 발생할 수 있습니다. 기능 개선 및 인터페이스, 계약 변경 사항에 대한 업데이트를 확인하기 위해 문서를 주시하시기 바랍니다. 여기에서 액세스를 요청하고 EVM 계정 주소를 허용 목록에 추가할 수 있습니다.
글 작성 시점에서는 서비스를 사용하기 위해서는 신청하고 웨이트리스트를 기다려야 했습니다.
https://chainlinkcommunity.typeform.com/requestaccess
여기에서 신청할 수 있습니다.
사용법
Chainlink Functions 스타터 킷과 Hardhat을 사용하여 온체인 컨트랙트를 설정하고 요청을 테스트하며 Chainlink Functions Decentralized Oracle Network (DON)에서 요청을 처리하도록 보내세요. Chainlink Functions는 Sepolia와 Polygon Mumbai에서 사용할 수 있지만, 이 안내서에서는 Polygon Mumbai를 사용하여 테스트넷 자금에 쉽게 액세스할 수 있도록 합니다. Chainlink Functions를 시작하려면 다음 작업을 완료하세요:
- Web3 지갑을 설정하고 개인 키를 찾으세요.
- 필요한 프레임워크를 설치하세요.
- 환경 변수로 스타터 킷을 구성하세요.
- Chainlink Functions 요청을 시뮬레이션하세요.
- Chainlink Functions를 위한 구독을 설정하세요.
- DON에 Chainlink Functions 요청을 보내세요.
환경 설정
다음 문서에서 예제를 실행하려면 테스트넷 지갑의 개인 키를 제공해야 합니다. Web3 지갑을 설치하고 Node.js를 구성하고 스타터 킷을 복제한 다음 필요한 변수로 .env 파일을 구성하세요.
스타터 킷 설정
Node.js 18을 설치하세요. 선택적으로 nvm 패키지를 사용하여 nvm use 18 명령으로 Node.js 버전을 전환할 수도 있습니다.
- 참고: Starter Kit은 Node.js 18 이상의 버전만 지원합니다. 터미널에서 올바른 버전을 실행 중인지 확인하려면 node -v 명령을 사용하세요.
- 로컬 컴퓨터에 이 저장소를 복제하세요.
git clone https://github.com/smartcontractkit/functions-hardhat-starter-kit.git
-
명령줄에서 해당 디렉토리를 열고 npm install을 실행하여 모든 종속성을 설치하세요.
-
Gists를 읽고 쓸 수 있는 Github 개인 액세스 토큰을 얻으세요.
-
https://github.com/settings/tokens?type=beta 에 방문하고 "Generate new token"을 클릭하세요.
-
토큰에 이름을 지정하고 "Account permissions" 드롭다운 메뉴에서 Gists에 대한 읽기 및 쓰기 액세스 권한을 활성화하세요. 추가 권한은 활성화하지 마세요.
-
"Generate token"을 클릭하고 생성된 개인 액세스 토큰을 복사하세요.
-
-
필요한 환경 변수를 설정하세요.
npx env-enc set-pw
명령을 실행하여 환경 변수의 암호화 비밀번호를 설정하세요.
npx env-enc set
명령을 사용하여 필요한 환경 변수를 설정하세요.
- GITHUB_API_TOKEN: 3단계에서 얻은 Github 토큰
- PRIVATE_KEY: 개발용 월렛의 개인 키
- POLYGON_MUMBAI_RPC_URL, ETHEREUM_SEPOLIA_RPC_URL, AVALANCHE_FUJI_RPC_URL: 사용할 네트워
크의 URL
- 필요한 경우, _API_KEY를 설정하여 계약을 검증하거나 Functions-request-config.js의 secrets 객체에 사용되는 값(COINMARKETCAP_API_KEY 등)을 설정할 수 있습니다.
-
기본 예제에서 사용되는 두 개의 파일에 유의하세요:
- contracts/FunctionsConsumer.sol: 데이터를 받을 스마트 계약
- calculation-example.js: DON의 각 노드에서 실행될 JavaScript 코드
-
npx hardhat functions-simulate 명령을 사용하여 로컬에서 엔드 투 엔드 요청과 이행을 시뮬레이션하여 테스트하세요.
-
npx hardhat functions-deploy-client --network network_name_here --verify true
network 종류
사용 예시
결과
명령을 실행하여 클라이언트 계약을 실제 블록체인 네트워크에 배포하고 검증하세요.
- 참고: --verify true를 사용하는 경우 _API_KEY가 설정되어 있는지 확인하고 사용하는 네트워크에 따라 값을 설정하세요.
명령을 실행하여 Functions 청구 구독을 생성하고 자금을 할당하고 권한을 부여하세요.npx hardhat functions-sub-create --network network_name_here --amount LINK_funding_amount_here --contract 0xDeployed_client_contract_address_here
- 참고: 해당 명령을 실행하기 전
에 월렛이 충분한 LINK 잔액을 가지고 있는지 확인하세요. 테스트넷 LINK는 faucets.chain.link에서 얻을 수 있습니다.
npx hardhat functions-request --network network_name_here --contract 0xDeployed_client_contract_address_here --subid subscription_id_number_here
network_name_here 여기에 사용할 네트워크 입력
명령을 실행하여 체인 상에서 요청을 수행하세요.
위와 같은 결과가 나오면 완료된 것입니다.
저같은 경우는 아직 베타 버젼이어서 위와 같은 에러나 다른 에러가 발생하며 안됬지만, 여러번 시도해서 성공을 하였습니다.
위의 단계를 따라하면 Chainlink Functions Starter Kit을 사용하여 체인 상에서 작업을 수행할 수 있습니다.
