Add `nft` CLI command for querying NFT metadata

[Levi-Ojukwu]

Description:

The contract has NFT functions (query_nft_metadata, query_nft_owner at nft.rs:247-254) but the CLI has no command to query them. Invoice NFTs represent ownership of funded invoices and are critical for secondary market features.

The CLI command should have two subcommands:

• iln nft metadata --invoice-id <id> — display NFT metadata (amount, due date, discount rate, token, owner, minted_at)
• iln nft owner --invoice-id <id> — display just the current owner address

Why it matters: NFT querying is essential for marketplace features and verifying invoice ownership.

Acceptance Criteria:

• Create cli/src/commands/nft.ts with metadata and owner subcommands
• Accept --invoice-id parameter
• Format metadata as a readable table
• Register in cli/src/index.ts as iln nft
• Add tests

Relevant Files: contracts/invoice_liquidity/src/nft.rs, cli/src/index.ts

---

[akinboyewaSamson]

Hello,

I’m a smart contract and full-stack developer interested in contributing to this issue.

I have experience contributing through OnlyDust and have participated in Drips Wave 4, Wave 5, Wave 6, as well as the GrantFox beta campaign.

My technical background includes Rust, Soroban, Cairo, Solidity, and TypeScript, with a focus on building secure, scalable, and maintainable blockchain applications.

Based on the scope of this issue, I’m confident I can deliver a complete and well-tested solution within 10hours of assignment. I prioritize clean code, clear documentation, and efficient implementation.

I’d appreciate the opportunity to contribute and help move this issue forward.

Thank you.

[prissca]

i will love to work on this issue, i have gone through the requirement and i understood it

[grantfox-oss]

🦊 GrantFox — @prissca has been assigned to this issue as part of the Official Campaign | FWC26 campaign!

Next steps:

1. Open a Pull Request referencing this issue (e.g., Closes #417)
2. Your PR will be reviewed by the Invoice-Liquidity-Network maintainers

Good luck! Track your progress on GrantFox.