Klaytn Docs
Search…
⌃K

mainbridge

APIs related to main chain ENs connected with a service chain.
The namespace mainbridge provides functions related to Service Chain. To use functions in this namespace, the option mainbridge should be enabled in the EN connected to the main chain (Mainnet or Baobab testnet).

mainbridge_nodeInfo

Returns bridge node information including the KNI (Klaytn Network Identifier) of the node. A mainbridge node can connect to a subbrige node via the KNI.
Parameters
None
Return Value
Type
Description
JSON string
the bridge node information.
Example
> mainbridge.nodeInfo
{
kni: "kni://f8a1f0cd1e2bebeece571e4fda16e215218fd4b9bc2eddd924f7cd5b5f950fcec[email protected][::]:50505?discport=0",
id: "f8a1f0cd1e2bebeece571e4fda16e215218fd4b9bc2eddd924f7cd5b5f950fcec8f4b8cd3851390d1d0bacf1b15e1c4a38c882252e429a28d16eeb6edbacd726",
ip: "::",
listenAddr: "[::]:50505",
name: "-2",
ports: {
discovery: 0,
listener: 50505
},
protocols: {
servicechain: {
config: {
chainId: 2018,
deriveShaImpl: 0,
isBFT: true,
istanbul: {...},
unitPrice: 0
},
difficulty: 87860,
genesis: "0x711ce9865492659977abb2758d29f68c2b0c82862d9376f25953579f64f95b58",
head: "0x0d4b130731f1e7560e4531ac73d55ac8c6daccb178abd86af0d96b7aafded7c5",
network: 1
}
}
}

mainbridge_addPeer

Returns true if adding a subbridge peer is done successfully.
It Adds a new remote node to the peer list. The node will try to maintain connectivity to these nodes at all times, reconnecting every once in a while if the remote connection goes down. The method accepts a single argument, the kni URL of the remote peer to start tracking and returns a BOOL indicating whether the peer was accepted for tracking or some error occurred.
Parameters
Name
Type
Description
url
string
Peer's kni URL.
Return Value
Type
Description
bool
true if the peer was accepted, false otherwise.
Example
Console
> mainbridge.addPeer("kni://[email protected]:50505") // or 'subbridge.addPeer'
true
HTTP RPC
$ curl -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"mainbridge_addPeer","params":["kni://a979fb575495b8d6db44f750317d0f4622bf4c2aa3365d6af7c284339968eef29[email protected]10.0.0.1:50505"],"id":1}' https://api.baobab.klaytn.net:8651
{"jsonrpc":"2.0","id":1,"result":true}

mainbridge_removePeer

Returns true if removing the peer is done successfully.
The removePeer method disconnects and removes the remote node in the list of tracked static nodes. The method accepts a single argument, the kni URL of the remote peer to start tracking and returns a BOOL indicating whether the peer was accepted for tracking or some error occurred.
Parameters
Name
Type
Description
url
string
Peer's kni URL.
Return Value
Type
Description
bool
true if the peer was removed, false otherwise.
Example
Console
> mainbridge.removePeer("kni://[email protected]:50505") // or 'subbridge.removePeer'
true
HTTP RPC
$ curl -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"mainbridge_removePeer","params":["kni://a979fb575495b8d6db44f750317d0f4622bf4c2aa3365d6af7c284339968eef29[email protected]10.0.0.1:50505"],"id":1}' https://api.baobab.klaytn.net:8651
{"jsonrpc":"2.0","id":1,"result":true}

mainbridge_getChildChainIndexingEnabled

mainbridge_getChildChainIndexingEnabled returns if indexing anchoring transaction is enabled or not.
Parameters
none
Return Value
Type
Description
bool
true if the indexing was enabled, false otherwise.
Example
> mainbridge.getChildChainIndexingEnabled()
true

mainbridge_convertChildChainBlockHashToParentChainTxHash

Returns the anchoring transaction hash of the given child chain block hash.
Parameters
Type
Description
32-byte DATA
The child chain block hash.
Return Value
Type
Description
32-byte DATA
The anchoring transaction hash that includes the child chain block information.
Example
Console
> mainbridge.convertChildChainBlockHashToParentChainTxHash("0xeadc6a3a29a20c13824b5df1ba05cca1ed248d046382a4f2792aac8a6e0d1880")
"0x9a68591c0faa138707a90a7506840c562328aeb7621ac0561467c371b0322d51"
HTTP RPC
$ curl -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"mainbridge_convertChildChainBlockHashToParentChainTxHash","params":["0xeadc6a3a29a20c13824b5df1ba05cca1ed248d046382a4f2792aac8a6e0d1880"],"id":1}' https://api.baobab.klaytn.net:8651
{"jsonrpc":"2.0","id":1,"result":"0x9a68591c0faa138707a90a7506840c562328aeb7621ac0561467c371b0322d51"}