Kaia (Klaytn) (KAIA)
Kaia (formerly Klaytn) is an EVM chain (eip155:8217/slip44:60). It signs through the standard EVM path; Klaytn-native features (fee-delegation, KCT) are wired — see the note below.
| Field | Value |
|---|---|
| Family | Klaytn / Kaia |
| coinType | 60 |
| keyPath | m/44'/60'/<accountIdx>'/0/0 |
| chainId · Mainnet | eip155:8217/slip44:60 |
| Testnet (Kairos) | eip155:1001/slip44:60 |
Supported Methods
| Method | Supported |
|---|---|
| getAddress | ✓ |
| signTransaction | ✓ |
| signMessage | ✓ |
| signTypedData EIP-712 | ✓ |
Requirements
Minimum firmware for each method. The two models are on different version lines, so DCENT Biometric Wallet and DCENT X are listed separately (the numbers are not comparable across models). Below this the request returns the firmware-update error (5005) and the bridge prompts to update.
| Method | DCENT Biometric Wallet | DCENT X |
|---|---|---|
getAddress | 1.5.1 or higher | 1.0.0 or higher |
signTransaction | 1.5.1 or higher | 1.0.0 or higher |
signMessage | 1.5.1 or higher | 1.0.0 or higher |
signTypedData | 2.11.1 or higher | 1.0.0 or higher |
Kaia routes to the Klaytn family. Plain EVM transfer, message, and EIP-712 typed-data all work, and Klaytn-native features are now wired: fee-delegation (sender side, typeInt: 9) returns the sender-partial RLP (senderTxHashRLP) for an external fee payer, and KIP-7 (KCT) tokens sign via the standard 0xa9059cbb calldata. Only fee-payer mode (kaia_signTransactionAsFeePayer — signing as the payer) is still not implemented.
getAddress — account address
Retrieves the Kaia address. Returns a checksummed 0x address, identical to EVM.
| Field | Type | Required | Notes |
|---|---|---|---|
chainId | string | Required | Full CAIP-19 — eip155:8217/slip44:60 |
keyPath | string | Required | BIP-44 path — default m/44'/60'/0'/0/0 |
Request
await dcent.getAddress({
chainId: 'eip155:8217/slip44:60',
keyPath: "m/44'/60'/0'/0/0"
})
Response
{
"header": {
"version": "1.0",
"status": "success"
},
"body": {
"command": "getAddress",
"parameter": {
"address": "0x…"
}
}
}
signTransaction
Signs a Kaia transaction. Today Kaia uses the EVM transaction shape (legacy or EIP-1559) and returns an RLP-encoded signed raw transaction — identical to Ethereum / EVM. Use chainId: 'eip155:8217/slip44:60'.
await dcent.sign({
method: 'signTransaction',
chainId: 'eip155:8217/slip44:60',
payload: {
keyPath: "m/44'/60'/0'/0/0",
transaction: {
type: 2,
to: '0x000000000000000000000000000000000000dEaD',
value: '0x…',
gasLimit: '0x…',
maxFeePerGas: '0x…',
maxPriorityFeePerGas: '0x…',
nonce: '0x0',
data: '0x'
}
}
})
| Field | Type | Required | Source | Notes |
|---|---|---|---|---|
type | number | Optional | App | 2 = EIP-1559 (recommended), 0 = legacy |
to | hex addr | Required-Real | App | Recipient |
value | hex | Required | App | Amount in peb (1 KAIA = 1e18) |
gasLimit | hex | Required-Real | App | — |
maxFeePerGas | hex | Required-Real | App | EIP-1559 fee |
maxPriorityFeePerGas | hex | Required-Real | App | EIP-1559 tip |
nonce | hex | Required-Real | App | Account nonce |
data | hex | Optional | App | 0x for native; calldata for contracts |
Response
| Field | Type | Notes |
|---|---|---|
body.parameter.signature | hex | Broadcast-ready RLP-encoded signed raw transaction |
body.command | string | "signTransaction" |
header.status | string | "success" on completion |
Payload fields and the response envelope match the Ethereum / EVM page. For Klaytn-native fee-delegation and KIP-7 (KCT) payloads, see the sections below.
Fee-delegation (sender)
For an externally fee-delegated transfer (a service pays the fee), the user signs as the sender. Set typeInt: 9 (FeeDelegatedValueTransfer); the response is the sender-partial RLP (senderTxHashRLP) that the fee payer counter-signs. This is a native value transfer, so to is the recipient.
payload.transaction:
{
"typeInt": 9,
"to": "0x<recipient>",
"value": "0x2386f26fc10000",
"gasLimit": "0x186a0",
"maxFeePerGas": "0x5d21dba00",
"maxPriorityFeePerGas": "0x0",
"nonce": "0x0",
"chainId": 8217,
"data": "0x"
}
| Field | Type | Required | Notes |
|---|---|---|---|
typeInt | number | Required | 9 = FeeDelegatedValueTransfer |
to | hex addr | Required-Real | Recipient (native transfer — to is the recipient) |
value | hex | Required | Amount in peb |
chainId | number | Required | 8217 |
gasLimit · maxFeePerGas · maxPriorityFeePerGas · nonce | hex | Required-Real | Fee + nonce (from RPC) |
data | hex | Optional | 0x for native |
Response: body.parameter.signature is the sender-partial RLP (senderTxHashRLP), not a broadcast-ready tx — hand it to the fee payer to counter-sign.
Change before sending: to → the real recipient address, and value → the real amount (here 0x2386f26fc10000 = 0.01 KAIA). For a native value transfer the tx to is the recipient.
KIP-7 (KCT) token transfer
Token model: EVM-family (form-E). KIP-7 (KCT) transfers use raw ERC-20 calldata like EVM. Unlike EVM, the form-D transaction.token descriptor path is not yet routed for Kaia — the device can only show a friendly label if it recognizes the token locally; otherwise it still signs, showing the raw contract call. See Core Concepts → Token descriptors.
KIP-7 uses the same transfer(address,uint256) selector as ERC-20 (0xa9059cbb). Here to is the token contract — leave it — and the recipient + amount live inside data.
payload.transaction:
{
"type": 2,
"to": "0x<token-contract>",
"value": "0x0",
"gasLimit": "0x186a0",
"maxFeePerGas": "0x77359400",
"maxPriorityFeePerGas": "0x3b9aca00",
"nonce": "0x0",
"data": "0xa9059cbb<recipient 32B><amount 32B>"
}
| Field | Type | Required | Notes |
|---|---|---|---|
type | number | Optional | 2 = EIP-1559 |
to | hex addr | Required-Real | The KIP-7 token contract (not the recipient) |
value | hex | Required | 0x0 (amount lives in data) |
data | hex | Required | 0xa9059cbb + recipient (32B) + amount (32B) |
Change before sending: keep to = the KIP-7 token contract. The real recipient is the 32 bytes after 0xa9059cbb in data (the preset ships all-zero) and the amount is the last 32 bytes (…03e8 = 1000 base units). Set both to real values so the device shows the correct KCT remap screen.
Common Mistakes
Fee-payer mode — signing as the fee payer (kaia_signTransactionAsFeePayer) is not implemented; only the sender side (typeInt: 9) is supported. KIP-7 recipient in to — for a KIP-7 transfer, to is the token contract; the recipient + amount go inside data (see the KIP-7 section above).