did

Description


API Methods


  • registerdid

    registerdid

    • Parameters (optional)
    1. -f or [--fee] The fee of tx. default_value 10 etp
    • Parameters (positional)
    1. ACCOUNTNAME Account name.
    2. ACCOUNTAUTH Account password/authorization.
    3. ADDRESS target address.
    4. SYMBOL register did symbol
      params:[
      "ACCOUNTNAME",
      "ACCOUNTAUTH",
      "ADDRESS",
      "SYMBOL"
      ]
    • Returns
      Object - transaction

    • Example

      // Request
      curl -X POST -d '{
      "id":25,
      "jsonrpc":"2.0",
      "method":"registerdid",
      "params":[
      "test",
      "123456",
      "MN3UNt5FbUbpsYtW6UfhcieykUb8rXKP5g",
      "TESTDID"
      ]
      }' http://127.0.0.1:8820/rpc/v3

      // Response
      {
      "id" : 25,
      "jsonrpc" : "2.0",
      "result" :
      {
      "hash" : "ed1394b9d6bb2798b3c449035334911a6357da10f833e2b9fe573b9dbad185b4",
      "inputs" :
      [
      {
      "address" : "MTfMLxFcYF2vLn3n1U1mCyjQgUES8Z4p49",
      "previous_output" :
      {
      "hash" : "f8df1cea4d765072ce09f87ef33aac3fc51de38c1308cc97060fd248f325466d",
      "index" : 0
      },
      "script" : "[ 304402202445059f1bea17a3f636fb4f51f4daee93c4c946cd8ddf5ef1bd143241df51000220144da3861858c1577f5235448db66720381de4d66fb997bb386ab4bdc8c9e10001 ] [ 024f353908de1c6f02436424de7f335477a4c2dde5891403c9df06b6de0661503d ]",
      "sequence" : 4294967295
      }
      ],
      "lock_time" : "0",
      "outputs" :
      [
      {
      "address" : "MTfMLxFcYF2vLn3n1U1mCyjQgUES8Z4p49",
      "attachment" :
      {
      "address" : "MN3UNt5FbUbpsYtW6UfhcieykUb8rXKP5g",
      "symbol" : "TESTDID",
      "type" : "did-register"
      },
      "index" : 0,
      "locked_height_range" : 0,
      "script" : "dup hash160 [ d8c5f7eb3c0a3f83a66b161baf74ffa330e4acac ] equalverify checksig",
      "value" : 0
      },
      {
      "address" : "MTfMLxFcYF2vLn3n1U1mCyjQgUES8Z4p49",
      "attachment" :
      {
      "type" : "etp"
      },
      "index" : 1,
      "locked_height_range" : 0,
      "script" : "dup hash160 [ d8c5f7eb3c0a3f83a66b161baf74ffa330e4acac ] equalverify checksig",
      "value" : 15299990000
      }
      ],
      "version" : "2"
      }
      }

  • listdids

    list dids details of blockchain.

    • Parameters (optional)
    1. -i or [--index] Page index. Default is 1.
    2. -l or [--limit] DID count per page.Default is 100.
    • Parameters (positional)

      params:[
      ]
    • Returns
      Object - dids

    • Example

      // Request
      curl -X POST --data '{"jsonrpc":"2.0","method":"listdids","id":42}' http://127.0.0.1:8820/rpc/v3

      // Response
      {
      "jsonrpc" : "2.0",
      "id": 42,
      "result":
      [
      "current_page" : 1,
      "dids" :
      [
      {
      "address" : "MN3UNt5FbUbpsYtW6UfhcieykUb8rXKP5g",
      "status" : "registered",
      "symbol" : "TESTDID"
      },
      {
      "address" : "35cY636TPTfFW8PxhqH3BNRL54g1T4mbR2",
      "status" : "registered",
      "symbol" : "MVS.TST"
      },
      {
      "address" : "M9kDHsDKJj9hM8FzSmDu4xCDbo2DFzUhzj",
      "status" : "registered",
      "symbol" : "YANG"
      }
      ],
      "total_count" : 3,
      "total_page" : 1
      ]
      }

  • listdids

    list dids details of account.

    • Parameters (optional)
    1. -i or [--index] Page index. Default is 1.
    2. -l or [--limit] DID count per page.Default is 100.
    • Parameters (positional)
    1. ACCOUNTNAME Account name.
    2. ACCOUNTAUTH Account password/authorization.
      params:[
      "ACCOUNTNAME",
      "ACCOUNTAUTH"
      ]
    • Returns
      Object - dids

    • Example

      // Request
      curl -X POST --data '{"jsonrpc":"2.0","method":"listdids",
      "params":["test", "123456"],"id":42}' http://127.0.0.1:8820/rpc/v3

      // Response
      {
      "jsonrpc" : "2.0",
      "id": 42,
      "result":
      [
      {
      "address" : "MN3UNt5FbUbpsYtW6UfhcieykUb8rXKP5g",
      "status" : "registered",
      "symbol" : "TESTDID"
      },
      {
      "address" : "M9kDHsDKJj9hM8FzSmDu4xCDbo2DFzUhzj",
      "status" : "registered",
      "symbol" : "YANG"
      }
      ]
      }

  • didchangeaddress

    change did address,and the toaddress will pay the fee,to prove that you own this address to hold the did.

    • Parameters (optional)
    1. -f or [--fee] The fee of tx. default_value 0.0001 etp
    • Parameters (positional)
    1. ACCOUNTNAME Account name.
    2. ACCOUNTAUTH Account password/authorization.
    3. TOADDRESS Target address
    4. SYMBOL Did symbol

      params:[
      "ACCOUNTNAME",
      "ACCOUNTAUTH",
      "TOADDRESS",
      "SYMBOL"
      ]
    • Returns
      Object -

    • Example

      // Request
      curl -X POST --data '{"jsonrpc":"2.0","method":"didmodifyaddress",
      "params":["test", "123456", "MFzPrUeNstFDTmnLdFYrD6PVtANS2281oP", "GUANG"],"id":7}' http://127.0.0.1:8820/rpc/v3

      // Response
      {
      "id" : 7,
      "jsonrpc" : "2.0",
      "result" :
      {
      "hash" : "65b139a3f589a3c6b10845b7660212f44f73db0dc25ed341549bad8908547202",
      "inputs" :
      [
      {
      "address" : "MKNCEEsdS7tzbGHAT8E6VEpaxTHd5nSuxA",
      "previous_output" :
      {
      "hash" : "4eb928fd66b1f25eb04b16fe4d6ee787b4015dabf41b5891a85609c2ebad60b7",
      "index" : 0
      },
      "script" : "[ 3045022100c01918d056fbe964bb90a5bfbec4e97052e596928afbb65b9b76ef16c8f3f062022035d43fd2a4d9e4998ba15ce31f026419ed3d20f560fb763ef32fc5dc761ca29101 ] [ 032c3803a8848f74b8ba96713d2222c6b4c43e526968c8461f83eb53bf935702e3 ]",
      "sequence" : 4294967295
      },
      {
      "address" : "MFzPrUeNstFDTmnLdFYrD6PVtANS2281oP",
      "previous_output" :
      {
      "hash" : "67d5ec0b346f9cdf2b3ccfb40d9010635d41ac7bfb921c4cee29df71d34cd8aa",
      "index" : 0
      },
      "script" : "[ 304402207fc66f31f97c2231b4bd05fee0cb0999b97487fb72f55c66533fbee224eeb5a3022056b8c7378543e88013d02c40a184db7d5624287750c0136d21c99421a5bb514801 ] [ 02b1d147fa3fbc815c6b2cdf1461fcede45c5fbf44cf4082d3ffe4faa452d36673 ]",
      "sequence" : 4294967295
      }
      ],
      "lock_time" : "0",
      "outputs" :
      [
      {
      "address" : "MFzPrUeNstFDTmnLdFYrD6PVtANS2281oP",
      "attachment" :
      {
      "address" : "MFzPrUeNstFDTmnLdFYrD6PVtANS2281oP",
      "symbol" : "GUANG",
      "type" : "did-transfer"
      },
      "index" : 0,
      "locked_height_range" : 0,
      "script" : "dup hash160 [ 58be74eccf7dc9a4edd067d63d75c5bae99c5913 ] equalverify checksig",
      "value" : 0
      },
      {
      "address" : "MFzPrUeNstFDTmnLdFYrD6PVtANS2281oP",
      "attachment" :
      {
      "type" : "etp"
      },
      "index" : 1,
      "locked_height_range" : 0,
      "script" : "dup hash160 [ 58be74eccf7dc9a4edd067d63d75c5bae99c5913 ] equalverify checksig",
      "value" : 299990000
      }
      ],
      "version" : "2"
      }
      }

  • getdid

    list dids.

    • Parameters (positional)

      params:[
      ]
    • Returns
      Object - did symbols

    • Example

      // Request
      curl -X POST --data '{"jsonrpc":"2.0","method":"getdid","params":[""],"id":42}' http://127.0.0.1:8820/rpc/v3

      // Response
      {
      "jsonrpc" : "2.0",
      "id": 42,
      "result":
      [
      "Alice",
      "Bob",
      "Cindy",
      "Dale"
      ]
      }

  • getdid

    list history addresses of did.

    • Parameters (positional)
    1. SYMDID/ADDRESS Did symbol or address .

      params:[
      "SYMDID/ADDRESS"
      ]
    • Returns
      Object - dids

    • Example

      // Request
      curl -X POST --data '{"jsonrpc":"2.0","method":"getdid","params":["MSvm4CPTvzhgktUXu7BKrHuFuUcZd7jqzK"],"id":42}' http://127.0.0.1:8820/rpc/v3

      // Response
      {
      "id" : 42,
      "jsonrpc" : "2.0",
      "result" :
      [
      {
      "address" : "MSvm4CPTvzhgktUXu7BKrHuFuUcZd7jqzK",
      "status" : "current",
      "symbol" : "Alice"
      }
      ]
      }