Documentation Index
Fetch the complete documentation index at: https://docs.stablenet.network/llms.txt
Use this file to discover all available pages before exploring further.
Foundry의 forge와 cast를 사용해 Solidity 컨트랙트를 StableNet Testnet에 배포합니다.
배우는 내용
이 튜토리얼을 완료하면 다음을 할 수 있습니다:
- StableNet Testnet을 위한 Foundry 프로젝트 구성
forge script로 WKRC 결제 컨트랙트 배포cast send로 컨트랙트 함수를 호출하고 Explorer에서 결과 확인
사전 준비
-
Foundry 설치 —
forge --version으로 확인. 미설치 시:
curl -L https://foundry.paradigm.xyz | bash
foundryup
-
Faucet에서 테스트넷 WKRC 받기
프로젝트 생성
forge init stablenet-demo
cd stablenet-demo
foundry.toml 설정
foundry.toml에 StableNet Testnet 엔드포인트를 추가합니다:
[profile.default]
src = "src"
out = "out"
libs = ["lib"]
[rpc_endpoints]
stablenet_testnet = "https://api.test.stablenet.network"
WKRCPayment.sol 작성
기본 파일을 삭제하고 src/WKRCPayment.sol을 생성합니다:
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
interface IERC20 {
function transferFrom(address from, address to, uint256 amount) external returns (bool);
function allowance(address owner, address spender) external view returns (uint256);
}
/// @title WKRCPayment
/// @notice 승인된 발신자로부터 WKRC 결제를 수락합니다.
contract WKRCPayment {
/// @dev NativeCoinAdapter (WKRC) — StableNet 고정 시스템 컨트랙트 주소.
IERC20 public constant WKRC =
IERC20(0x0000000000000000000000000000000000001000);
event Payment(address indexed from, address indexed to, uint256 amount);
/// @notice msg.sender로부터 `amount`의 WKRC를 당겨와 `to`에 전송합니다.
/// 사전에 WKRC.approve(address(this), amount)를 호출해야 합니다.
function pay(address to, uint256 amount) external {
require(WKRC.transferFrom(msg.sender, to, amount), "WKRC transfer failed");
emit Payment(msg.sender, to, amount);
}
function allowanceOf(address owner) external view returns (uint256) {
return WKRC.allowance(owner, address(this));
}
}
[⠒] Compiling...
Compiler run successful!
배포 스크립트 작성
script/DeployWKRCPayment.s.sol을 생성합니다:
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
import {Script, console} from "forge-std/Script.sol";
import {WKRCPayment} from "../src/WKRCPayment.sol";
contract DeployWKRCPayment is Script {
function run() external {
vm.startBroadcast();
WKRCPayment payment = new WKRCPayment();
console.log("WKRCPayment deployed at:", address(payment));
vm.stopBroadcast();
}
}
Testnet에 배포
개인 키를 버전 관리 시스템에 커밋하지 마세요. .env 파일에 저장하고 .gitignore에 추가하세요.
export PRIVATE_KEY=0xYourPrivateKey
forge script script/DeployWKRCPayment.s.sol \
--rpc-url https://api.test.stablenet.network \
--private-key $PRIVATE_KEY \
--priority-gas-price 27600000000000 \
--broadcast
Script ran successfully.
== Logs ==
WKRCPayment deployed at: 0xABC...
Chain 8283
✅ Hash: 0xDEF...
Contract Address: 0xABC...
Block: NNNN
StableNet은 GovValidator 컨트랙트가 설정한 최소 priority fee를 적용합니다. 모든 forge script와 cast send 호출에 --priority-gas-price 27600000000000을 전달하세요.
WKRC 승인 후 결제
pay()를 호출하기 전에 배포한 컨트랙트가 지갑의 WKRC를 사용할 수 있도록 승인해야 합니다:
export CONTRACT=0xABC...
export RECIPIENT=0xRecipientAddress
export AMOUNT=1000000000000000000
export WKRC=0x0000000000000000000000000000000000001000
# 컨트랙트가 1 WKRC를 사용하도록 승인
cast send $WKRC \
"approve(address,uint256)" $CONTRACT $AMOUNT \
--rpc-url https://api.test.stablenet.network \
--private-key $PRIVATE_KEY \
--priority-gas-price 27600000000000
# pay()를 호출해 수신자에게 전송
cast send $CONTRACT \
"pay(address,uint256)" $RECIPIENT $AMOUNT \
--rpc-url https://api.test.stablenet.network \
--private-key $PRIVATE_KEY \
--priority-gas-price 27600000000000
cast call $CONTRACT \
"allowanceOf(address)(uint256)" $RECIPIENT \
--rpc-url https://api.test.stablenet.network
Explorer에서 확인
explorer.stablenet.network를 열고 컨트랙트 주소를 검색합니다. 배포 트랜잭션, WKRC 컨트랙트에서의 approve 호출, 로그에 Payment 이벤트가 포함된 pay 호출을 확인할 수 있습니다.
다음 단계
Hardhat으로 배포하기
Hardhat과 ethers.js로 같은 컨트랙트를 배포합니다.
이벤트 구독하기
WebSocket으로 온체인 이벤트를 구독합니다.
RPC API 레퍼런스
지원되는 JSON-RPC 메서드 전체 목록.
수수료 위임
별도 계정이 사용자 대신 가스를 납부하게 합니다.
