Optimism Documentation

이 튜토리얼에서는 서로 통신할 수 있는 OP Stack 및 Ethereum용 Solidity 컨트랙트를 작성하는 방법을 설명합니다. 여기서는 OP Stack의 컨트랙트를 사용하여 Ethereum의 컨트랙트에 “greeting” 변수를 설정하고, 그 반대 방향으로도 설정합니다. 간단한 예제이지만, 동일한 기법을 사용하여 두 체인 간에 어떤 종류의 메시지든 보낼 수 있습니다. 이 튜토리얼에서는 실제로 스마트 컨트랙트를 배포하지 않습니다. 대신 OP Stack과 Ethereum에 이미 배포된 기존 컨트랙트를 재사용합니다. 튜토리얼 후반부에서는 이 컨트랙트들이 정확히 어떻게 동작하는지 배우게 되므로, 같은 패턴을 따라 직접 컨트랙트를 배포할 수 있습니다.

OP Stack과 Ethereum 간에 토큰을 브리징하는 방법만 찾고 있습니까? viem으로 OP Stack에 ERC-20 토큰 브리징하기 튜토리얼을 확인하십시오.

메시지 전달 기본 사항

OP Stack은 CrossDomainMessenger라는 스마트 컨트랙트를 사용하여 OP Stack과 Ethereum 간에 메시지를 전달합니다. 두 체인 모두 이 컨트랙트의 버전(L1CrossDomainMessenger 및 L2CrossDomainMessenger)을 가지고 있습니다. Ethereum에서 OP Stack으로 보낸 메시지는 내부적으로 자동 릴레이됩니다. OP Stack에서 Ethereum으로 보낸 메시지는 Ethereum에서 두 번째 트랜잭션을 통해 명시적으로 릴레이해야 합니다. 메시지 전달에 대한 자세한 내용은 L1과 L2 간 데이터 전송 가이드를 참조하십시오.

의존성

node
pnpm

Sepolia 및 OP Sepolia에서 ETH 받기

이 튜토리얼에서는 Sepolia에서 OP Sepolia로 메시지를 보내는 방법을 설명합니다. 두 testnet 모두에서 약간의 ETH가 필요합니다.

컨트랙트 검토

Sepolia와 OP Sepolia에 이미 배포된 두 개의 컨트랙트, 즉 Greeter 컨트랙트를 사용하게 됩니다. L1 Greeter 컨트랙트의 소스 코드는 Etherscan의 여기에서 검토할 수 있습니다. L2 Greeter 컨트랙트의 소스 코드는 Etherscan의 여기에서 검토할 수 있습니다. 두 컨트랙트의 소스 코드는 완전히 동일합니다. 원한다면 지금 두 컨트랙트의 소스 코드를 검토해도 좋습니다. 이 튜토리얼에서는 아래의 동작 방식 섹션에서 이 컨트랙트들이 어떻게 동작하는지 자세히 설명합니다.

L1 Greeter와 상호작용하기

먼저 L1 Greeter 컨트랙트를 사용하여 L2 Greeter 컨트랙트에 greeting을 설정합니다. L1 Greeter 컨트랙트에 직접 트랜잭션을 보내면, 이 컨트랙트가 L1CrossDomainMessenger에 L2 Greeter 컨트랙트로 메시지를 보내도록 요청합니다. 몇 분만 지나면 L2 Greeter 컨트랙트에 해당 greeting이 설정된 것을 확인할 수 있습니다.

Etherscan에 연결

L1 Greeter 컨트랙트를 통해 L2 Greeter 컨트랙트로 메시지를 보내려면 sendGreeting 함수를 호출해야 합니다. 간단하게 하기 위해 Etherscan에서 컨트랙트와 직접 상호작용합니다. Sepolia Etherscan의 L1 Greeter 컨트랙트를 열고 “Connect to Web3” 버튼을 클릭합니다.

greeting 보내기

“sendGreeting” 함수 옆의 필드에 greeting을 입력하고 “Write” 버튼을 클릭합니다. 원하는 어떤 greeting이든 사용할 수 있습니다.

몇 분 기다리기

메시지가 L2에 도달하기까지 몇 분 정도 걸립니다. 기다리는 동안 잠시 쉬어도 좋습니다.

viem을 사용하면 L1과 L2 간 모든 메시지의 상태를 프로그래밍 방식으로 확인할 수 있습니다. 이 튜토리얼 후반부에서는 viem과 waitToProve 함수를 사용하여 다양한 메시지 상태를 기다리는 방법을 배우게 됩니다. 이 함수는 L1에서 L2로 메시지가 릴레이될 때까지 기다리는 데에도 사용할 수 있습니다.

L2 Greeter 확인

몇 분 후 L2 Greeter 컨트랙트의 greeting이 설정한 greeting으로 변경된 것을 확인할 수 있습니다. OP Sepolia Etherscan의 L2 Greeter 컨트랙트를 열고 “Read Contract” 버튼을 클릭합니다. “greeting” 함수 옆의 필드에 주소를 붙여 넣고 “Query” 버튼을 클릭합니다. L1에서 보낸 메시지가 표시되어야 합니다.

L2 Greeter와 상호작용하기

이제 L2 Greeter 컨트랙트를 사용하여 L1 Greeter 컨트랙트에 greeting을 설정합니다. L2 Greeter 컨트랙트에 직접 트랜잭션을 보내면, 이 컨트랙트가 L2CrossDomainMessenger에 L1 Greeter 컨트랙트로 메시지를 보내도록 요청합니다. 이전 단계와 달리 L2에서 L1으로의 메시지는 직접 릴레이해야 합니다. 이를 위해 Sepolia에서 증명 트랜잭션 하나와 릴레이 트랜잭션 하나, 총 두 개의 트랜잭션을 보냅니다.

Etherscan에 연결

이전과 마찬가지로 L2 Greeter 컨트랙트를 통해 L1 Greeter 컨트랙트로 메시지를 보내려면 sendGreeting 함수를 호출해야 합니다. OP Sepolia Etherscan의 L2 Greeter 컨트랙트를 열고 “Connect to Web3” 버튼을 클릭합니다.

greeting 보내기

“sendGreeting” 함수 옆의 필드에 greeting을 입력하고 “Write” 버튼을 클릭합니다. 원하는 어떤 greeting이든 사용할 수 있습니다.

방금 보낸 트랜잭션의 트랜잭션 해시를 복사하십시오. 다음 몇 단계에서 필요합니다. 나중에 트랜잭션 해시를 쉽게 복사할 수 있도록 이 탭을 열어 두어도 좋습니다.

데모 프로젝트 생성

viem을 사용하여 메시지를 증명하고 L1으로 릴레이합니다.

mkdir cross-dom
cd cross-dom
pnpm init
pnpm add viem@^2.51.0

환경 변수 추가

개인 키와 트랜잭션 해시를 환경 변수로 설정합니다.

export TUTORIAL_PRIVATE_KEY=0x...
export TUTORIAL_TRANSACTION_HASH=0x...

Node REPL에서 스크립트 실행

node로 Node.js REPL을 시작하고 다음 스크립트를 붙여 넣어 크로스 도메인 메시지를 모니터링, 증명 및 최종 확정합니다.

const { createPublicClient, http, createWalletClient } = require('viem');
const { optimismSepolia, sepolia } = require('viem/chains');
const { publicActionsL1, publicActionsL2, walletActionsL1, walletActionsL2, getWithdrawals, isSuperGameType } = require('viem/op-stack');
const { privateKeyToAccount } = require('viem/accounts');

const l1Provider = createPublicClient({
  chain: sepolia,
  transport: http('https://eth-sepolia.g.alchemy.com/v2/your-key')
}).extend(publicActionsL1());

const l2Provider = createPublicClient({
  chain: optimismSepolia,
  transport: http('https://opt-sepolia.g.alchemy.com/v2/your-key')
}).extend(publicActionsL2());

const account = privateKeyToAccount(process.env.TUTORIAL_PRIVATE_KEY);

const l1Wallet = createWalletClient({
  account,
  chain: sepolia,
  transport: http('https://eth-sepolia.g.alchemy.com/v2/your-key')
}).extend(walletActionsL1());

const l2Wallet = createWalletClient({
  account,
  chain: optimismSepolia,
  transport: http('https://opt-sepolia.g.alchemy.com/v2/your-key')
}).extend(walletActionsL2());

const receipt = await l2Provider.getTransactionReceipt({
  hash: process.env.TUTORIAL_TRANSACTION_HASH
});
const withdrawalBlock = await l2Provider.getBlock({
  blockNumber: receipt.blockNumber
});
const respectedGameType = await l1Provider.readContract({
  abi: [{
    inputs: [],
    name: 'respectedGameType',
    outputs: [{ type: 'uint32' }],
    stateMutability: 'view',
    type: 'function'
  }],
  address: l2Provider.chain.contracts.portal[l1Provider.chain.id].address,
  functionName: 'respectedGameType'
});
const proveContext = isSuperGameType(Number(respectedGameType))
  ? { l2Timestamp: withdrawalBlock.timestamp }
  : {};

console.log('Waiting for message to be provable...');
await l1Provider.getWithdrawalStatus({
  ...proveContext,
  receipt,
  targetChain: l2Provider.chain
});

console.log('Proving message...');
const { game, withdrawal } = await l1Provider.waitToProve({
  ...proveContext,
  receipt,
  targetChain: l2Provider.chain
});

const proveArgs = await l2Provider.buildProveWithdrawal({
  account,
  game,
  withdrawal
});

await l1Wallet.proveWithdrawal(proveArgs);

console.log('Waiting for message to be relayable...');
await l1Provider.waitToFinalize({
  targetChain: l2Provider.chain,
  withdrawalHash: withdrawal.withdrawalHash
});

console.log('Relaying message...');
await l1Wallet.finalizeWithdrawal({
  targetChain: l2Wallet.chain,
  withdrawal
});

console.log('Message relayed!');

L1 greeting 확인

최종 확정 후 Sepolia Etherscan의 L1 Greeter 컨트랙트를 엽니다. greeting이 L2에서 보낸 메시지로 업데이트되었는지 확인합니다.

동작 방식

축하합니다! L1에서 L2로, 그리고 L2에서 L1으로 메시지를 성공적으로 보냈습니다. 이 섹션에서는 Greeter 컨트랙트가 어떻게 동작하는지 설명하므로, 같은 패턴을 따라 직접 컨트랙트를 배포할 수 있습니다. 다행히 두 Greeter 컨트랙트는 완전히 동일하므로 모든 것이 어떻게 맞물려 동작하는지 쉽게 확인할 수 있습니다.

Messenger 변수

Greeter 컨트랙트에는 현재 체인의 CrossDomainMessenger 컨트랙트를 추적하는 MESSENGER 변수가 있습니다. 사용할 네트워크의 CrossDomainMessenger 컨트랙트 주소는 컨트랙트 주소 페이지에서 확인하십시오.

address public immutable MESSENGER;

상대 Greeter 변수

Greeter 컨트랙트에는 다른 체인의 Greeter 컨트랙트를 추적하는 OTHER_GREETER 변수도 있습니다. L1에서는 이 변수가 L2 Greeter 컨트랙트의 주소로 설정되며, 그 반대도 마찬가지입니다.

address public immutable OTHER_GREETER;

Greetings 매핑

Greeter 컨트랙트는 사용자가 보낸 여러 greeting을 greetings 매핑에 저장하여 추적합니다. 매핑을 사용하므로 이 컨트랙트는 여러 사용자의 greeting을 동시에 추적할 수 있습니다.

mapping(address => string) public greetings;

생성자

Greeter에는 MESSENGER 및 OTHER_GREETER 변수를 설정하는 간단한 생성자가 있습니다.

constructor(address messenger, address otherGreeter) {
  MESSENGER = messenger;
  OTHER_GREETER = otherGreeter;
}

sendGreeting 함수

sendGreeting 함수는 Greeter 컨트랙트에서 가장 중요한 함수입니다. 앞서 양방향으로 메시지를 보낼 때 호출한 함수가 바로 이것입니다. 이 함수는 CrossDomainMessenger 컨트랙트에 있는 sendMessage 함수를 사용하여 다른 체인의 Greeter 컨트랙트로 메시지를 보내는 일만 합니다.

function sendGreeting(string calldata newGreeting) external payable {
  ICrossDomainMessenger(MESSENGER).sendMessage(
    OTHER_GREETER,
    abi.encodeWithSelector(Greeter.setGreeting.selector, msg.sender, newGreeting),
    100_000
  );
}

setGreeting 함수

setGreeting 함수는 실제로 greeting을 설정하는 함수입니다. 이 함수는 다른 체인의 CrossDomainMessenger 컨트랙트에 의해 호출됩니다. 이 함수는 CrossDomainMessenger 컨트랙트만 호출할 수 있는지 명시적으로 확인합니다. 또한 CrossChainMessenger가 해당 메시지가 다른 체인의 Greeter 컨트랙트에서 왔다고 알려 주는지도 확인합니다. 마지막으로 greetings 매핑에 greeting을 설정합니다.

function setGreeting(address sender, string calldata newGreeting) external {
  require(msg.sender == MESSENGER, "Only messenger");
  require(
    ICrossDomainMessenger(MESSENGER).xDomainMessageSender() == OTHER_GREETER,
    "Only remote greeter"
  );
  greetings[sender] = newGreeting;
}

이 함수에 있는 두 개의 require 문은 중요합니다. 이 문이 없으면 누구나 이 함수를 호출하여 greeting을 원하는 값으로 설정할 수 있습니다. 직접 작성하는 스마트 컨트랙트에서도 비슷한 패턴을 따를 수 있습니다.

결론

방금 Sepolia와 OP Sepolia에서 서로 통신할 수 있는 Solidity 컨트랙트를 작성하는 방법을 배웠습니다. 같은 패턴을 따라 Ethereum과 OP Stack에서 서로 통신할 수 있는 컨트랙트를 작성할 수 있습니다.

interface ICrossDomainMessenger {
  function sendMessage(address target, bytes calldata message, uint32 gasLimit) external;
  function xDomainMessageSender() external view returns (address);
}

이러한 종류의 크로스체인 통신은 다양한 이유로 유용합니다. 예를 들어 Standard Bridge 컨트랙트는 이와 동일한 시스템을 사용하여 Ethereum과 OP Stack 간에 ETH 및 ERC-20 토큰을 브리징합니다. 크로스체인 통신을 활용하는 좋은 방법 중 하나는 대부분의 무거운 작업을 OP Stack에서 수행한 다음, 공유할 중요한 결과가 있을 때만 Ethereum으로 메시지를 보내는 것입니다. 이렇게 하면 OP Stack의 낮은 gas 비용을 활용하면서도 필요할 때는 Ethereum을 사용할 수 있습니다.

앱 구축

가이드

튜토리얼

도구 및 SDK

참조

Solidity로 OP Stack과 Ethereum 간 통신하기

메시지 전달 기본 사항

의존성

Sepolia 및 OP Sepolia에서 ETH 받기

컨트랙트 검토

L1 Greeter와 상호작용하기

L2 Greeter와 상호작용하기

동작 방식

Messenger 변수

상대 Greeter 변수

Greetings 매핑

생성자

sendGreeting 함수

setGreeting 함수

결론

​메시지 전달 기본 사항

​의존성

​Sepolia 및 OP Sepolia에서 ETH 받기

​컨트랙트 검토

​L1 Greeter와 상호작용하기

​L2 Greeter와 상호작용하기

​동작 방식

​Messenger 변수

​상대 Greeter 변수

​Greetings 매핑

​생성자

​sendGreeting 함수

​setGreeting 함수

​결론

메시지 전달 기본 사항

의존성

Sepolia 및 OP Sepolia에서 ETH 받기

컨트랙트 검토

L1 Greeter와 상호작용하기

L2 Greeter와 상호작용하기

동작 방식

Messenger 변수

상대 Greeter 변수

Greetings 매핑

생성자

sendGreeting 함수

setGreeting 함수

결론