[2.6.0] gettxout RPC does not work

[ixje]

I'm using the host: https://seed1.neo.org:20331
which runs v2.6.0

{
    "jsonrpc": "2.0",
    "id": 3,
    "result": {
        "port": 20333,
        "nonce": 518138340,
        "useragent": "/NEO:2.6.0/"
    }
}

Getting block 730901 from TestNet, I expect the outputs below (ommited some parts of the response for readability) (see also on a block explorer here)

{
  "jsonrpc": "2.0",
  "method": "getblock",
  "params": ["8e47b5a3f25ea286e01cb88fdf6933d8438ee6764ae9e9cfc2a22be90c4ba10d", 1],
  "id": 1
}

# expected
{
    "jsonrpc": "2.0",
    "id": 1,
    "result": {
        "hash": "0x8e47b5a3f25ea286e01cb88fdf6933d8438ee6764ae9e9cfc2a22be90c4ba10d",
        ...
        "index": 730901,
        ...
        "tx": [
            {
                "txid": "0x2f90e1bb81f12bdb9c8c22d6067f6a065d1d2e4911df872c9b69d7e403170a1b",
                "type": "MinerTransaction",
             ...
            },
            {
                "txid": "0x0ff23561c611ccda65470c9a4a5f1be31f2f4f61b98c75d051e1a72e85a302eb",
                "type": "ContractTransaction",
                 ...
                "vout": [
                    {
                        "n": 0,
                        "asset": "0x602c79718b16e442de58778e148d0b1084e3b2dffd5de6b7b16cee7969282de7",
                        "value": "20",
                        "address": "AVTfssLYDp3pTYQRfnsmaEG8vAQh5GQq2K"
                    },
                    {
                        "n": 1,
                        "asset": "0x602c79718b16e442de58778e148d0b1084e3b2dffd5de6b7b16cee7969282de7",
                        "value": "25",
                        "address": "AHYb3ySrHbhzouZ81ZMnCf8c7zYaoDg64x"
                    }
                ],
             ...
            }
        ],
    ...
    }
}

Using gettxout I get a null result.

{
   "jsonrpc": "2.0",
   "method": "gettxout",
   "params": ["0ff23561c611ccda65470c9a4a5f1be31f2f4f61b98c75d051e1a72e85a302eb", 0],
   "id": 1
}
# response
{
    "jsonrpc": "2.0",
    "id": 1,
    "result": null
}

where I according to the documentation should expect:

{
   "jsonrpc": "2.0",
   "id": 1,
   "result": {
                        "n": 0,
                        "asset": "602c79718b16e442de58778e148d0b1084e3b2dffd5de6b7b16cee7969282de7",
                        "value": "20",
                        "address": "AVTfssLYDp3pTYQRfnsmaEG8vAQh5GQq2K"
   }
}

[erikzhang]

The RPC method gettxout returns unspent output only. If it is spent, the mothod returns null.

[ixje]

@erikzhang thanks for clarifying. Would it make sense to throw an RpcException like done in some other places? for example here

pseudo code

TransactionOutput  out = Blockchain.Default.GetUnspent(hash, index);
if (out == null) {
   throw new RpcException(-100, "Output already spent");
} else {
   return out.ToJson(index);
}

I can PR the above, or if you wish to keep it as null then I'll update docs.neo.org to elaborate on the return values.

[erikzhang]

Please update http://docs.neo.org.
Thanks!

[ixje]

Closing because I updated the documentation that clarifies the issue.