본문으로 건너뛰기
이 페이지는 영문에서 기계 번역되었으므로 오역이나 어색한 표현이 있을 수 있습니다. 따라서 정확한 정보는 영어 원문을 참조하시기 바랍니다. 또한 잦은 업데이트로 인해 일부 콘텐츠는 영문이 그대로 남아있을 수 있습니다. Crowdin에서 이 페이지의 번역을 개선하는 데 동참하여 도움을 주세요. (Crowdin translation page, Contributing guide)

수수료 위임 기능을 지갑에 통합하는 방법

카이아의 네이티브 수수료 위임 기능 덕분에 사용자들은 dApp에서 가스비 없이 거래를 이용할 수 있습니다. 이를 활성화하려면 지갑이 수수료 위임 거래 유형을 지원하고 발신자 서명을 수행해야 합니다.

이 가이드의 대상

이 가이드는 지갑 제공업체를 위한 것입니다. 이 지갑은 발신자 측 기능만 구현하고 있습니다:

  • 사용자의 키로 수수료 위임 거래에 서명하기
  • senderTxHashRLP를 dApp에 반환합니다.

수수료 납부자의 서명 및 방송은 지갑의 책임이 아닙니다. 이러한 작업은 dApp 백엔드나 Kaia 수수료 위임 서비스와 같은 관리형 서비스에서 처리합니다.

종단 간 흐름 (역할)​

수수료 위임에는 항상 동일한 주체들이 관여합니다. 아래 다이어그램은 전체 경로를 보여줍니다. 이후 섹션에서는 이 경로를 재사용하며, 설명 대상인 행위자를 강조 표시합니다.

단계누구책임
1지갑 (당신)수수료 위임 거래에 서명하고 senderTxHashRLP를 반환합니다. 절대 방송하지 마십시오.
2dAppsenderTxHashRLP를 수수료 납부자에게 전달하십시오.
3수수료 납부자다시 서명한 후, 서명이 모두 완료된 거래 내역을 카이아에 제출하십시오.

이 페이지에서는 1단계에 대해 자세히 설명합니다. 2~3단계는 마지막 부분에 요약되어 있으며, 전체 가이드로 연결되는 링크도 함께 제공됩니다.

지갑이 구현해야 할 사항​

이것은 흐름의 1단계로, 지갑이 반드시 구현해야 하는 유일한 부분입니다.

수수료 위임을 지원하려면 지갑 내에서 다음을 구현하십시오:

  1. 지갑 코드베이스에 Kaia SDK(예: @kaiachain/ethers-ext)를 추가합니다.
  2. 지갑이 수수료 위임 거래 요청(일반적으로 kaia_signTransaction을 통해)을 수신하면, Kaia SDK를 사용하여 사용자의 키로 해당 거래에 서명합니다.
  3. senderTxHashRLP를 dApp에 반환합니다. 지갑에서 Kaia 노드로 트랜잭션을 절대 전송하지 마십시오.
지갑 제공업체를 위한 체크리스트
  • 수수료 위임 거래 유형(가치 이체, 계약 체결 및 기타 필요한 유형) 지원
  • 지갑에서 관리하는 발신자(사용자) 키로 서명하세요
  • senderTxHashRLP를 dApp에 반환합니다.
  • 발신자만 서명한 트랜잭션은 전송하지 마십시오

예시: 수수료 위임 방식의 가치 이체 서명​

이 패턴을 지갑의 서명 경로(예를 들어, kaia_signTransaction 핸들러 내부)에서 사용하십시오. 실제 운영 환경에서는 하드코딩된 개인 키가 아닌, 지갑에서 관리하는 사용자의 키를 사용하고, 호출자에게 senderTxHashRLP를 반환해야 합니다.


const ethers = require("ethers6");
const { Wallet, TxType, parseKaia } = require("@kaiachain/ethers-ext/v6");
const senderAddr = "0xa2a8854b1802d8cd5de631e690817c253d6a9153";
const senderPriv = "0x0e4ca6d38096ad99324de0dde108587e5d7c600165ae4cd6c2462c597458c2b8";
const receiverAddr = "0xc40b6909eb7085590e1c26cb3becc25368e249e9";
const provider = new ethers.JsonRpcProvider("https://public-en-kairos.node.kaia.io");
const senderWallet = new Wallet(senderPriv, provider);
async function main() {
const tx = {
type: TxType.FeeDelegatedValueTransfer,
from: senderAddr,
to: receiverAddr,
value: parseKaia("0.01"),
};
// Wallet: populate and sign as sender, then return RLP to the dApp
const populatedTx = await senderWallet.populateTransaction(tx);
const senderTxHashRLP = await senderWallet.signTransaction(populatedTx);
console.log("senderTxHashRLP", senderTxHashRLP);
// return senderTxHashRLP; // ← wallet returns this to the dApp (do not broadcast)
}

예시: 수수료 위임 계약 상호작용 체결​


const ethers = require("ethers6");
const { Wallet, TxType } = require("@kaiachain/ethers-ext/v6");
const senderAddr = "0xa2a8854b1802d8cd5de631e690817c253d6a9153";
const senderPriv = "0x0e4ca6d38096ad99324de0dde108587e5d7c600165ae4cd6c2462c597458c2b8";
const provider = new ethers.JsonRpcProvider("https://public-en-kairos.node.kaia.io");
const senderWallet = new Wallet(senderPriv, provider);
const contractAddr = "0x95Be48607498109030592C08aDC9577c7C2dD505";
const abi = ["function setNumber(uint256 newNumber)"];
async function main() {
const contract = new ethers.Contract(contractAddr, abi, provider);
const data = contract.interface.encodeFunctionData("setNumber", ["0x123"]);
const tx = {
type: TxType.FeeDelegatedSmartContractExecution,
from: senderAddr,
to: contractAddr,
value: 0,
data: data,
};
// Wallet: populate and sign as sender, then return RLP to the dApp
const populatedTx = await senderWallet.populateTransaction(tx);
const senderTxHashRLP = await senderWallet.signTransaction(populatedTx);
console.log("senderTxHashRLP", senderTxHashRLP);
// return senderTxHashRLP; // ← wallet returns this to the dApp (do not broadcast)
}

노트

구체적인 배선 방식은 지갑의 아키텍처에 따라 달라집니다. 중요한 계약 사항은 다음과 같습니다. 위임된 유형을 발신자로 서명하고, senderTxHashRLP를 반환하며, 브로드캐스트하지 마십시오.

지갑 외부: 수수료 납부자의 서명​

지갑이 senderTxHashRLP를 반환하면, dApp이 이를 전달하고(2단계), 수수료 지불자가 서명하여 제출합니다(3단계). 아래에 강조 표시된 부분이 수수료 납부자입니다. 이는 지갑 코드가 아닙니다.


// Fee payer / backend only — not wallet code
const sentTx = await feePayerWallet.sendTransactionAsFeePayer(senderTxHashRLP);
console.log("sentTx", sentTx);
const rc = await sentTx.wait();
console.log("receipt", rc);

수수료 지불자가 senderTxHashRLP를 수신하고 트랜잭션을 제출하는 과정을 확인하려면(간단한 클라이언트/서버 데모이며, 지갑 통합 기능은 아님), 수수료 위임 예제 만들기를 참조하십시오. 관리형 수수료 납부자의 경우, Kaia 수수료 위임 서비스 통합을 참조하십시오.

다음 단계​

목표안내
수수료 위임 거래 유형 이해하기수수료 위임, 부분 수수료 위임
클라이언트/서버 수수료 납부자 데모(지갑 코드가 아님)를 확인해 보세요.빌드 수수료 위임 예시
dApp에 카이아(Kaia)의 관리형 수수료 납부 기능을 활용하세요Kaia 수수료 위임 서비스 통합
수수료 위임 거래에 대한 SDK 참조 자료이더스-익스텐드 수수료 위임형 가치 전송
페이지를 개선해 주세요