Skip to content

Latest commit

 

History

History
32 lines (22 loc) · 1.92 KB

filegetinfo.md

File metadata and controls

32 lines (22 loc) · 1.92 KB

FileGetInfo

FileGetInfoQuery

Get all of the information about a file, except for its contents. When a file expires, it no longer exists, and there will be no info about it, and the fileInfo field will be blank. If a transaction or smart contract deletes the file, but it has not yet expired, then the fileInfo field will be non-empty, the deleted field will be true, its size will be 0, and its contents will be empty. Note that each file has a FileID, but does not have a filename.

Field Type Description
header QueryHeader Standard info sent from client to node, including the signed payment, and what kind of response is requested (cost, state proof, both, or neither).
fileID FileID The file ID of the file for which information is requested

FileGetInfoResponse

Response when the client sends the node FileGetInfoQuery

Field Type Description
header ResponseHeader Standard response from node to client, including the requested fields: cost, or state proof, or both, or neither
fileInfo FileGetInfoResponse.FileInfo The information about the file (a state proof can be generated for this)

FileGetInfoResponse.FileInfo

Response when the client sends the node FileGetInfoQuery

Field Type Description
fileID FileID The file ID of the file for which information is requested
size Number of bytes in contents
expirationTime Timestamp The current time at which this account is set to expire
deleted True if deleted but not yet expired
keys KeyList One of these keys must sign in order to modify or delete the file