ERC-8348 Financial lease contract interface (Financial Lease)
Draft · Vaults & DeFi · created 2026-07-23
A jurisdiction-neutral interface for querying a lease contract's payment schedule, balance, arrears, default status, purchase option, and party assignment. It represents lessee status as an ERC-721 token, so portfolio transfer and securitization can use existing NFT infrastructure.
Why it is needed
Leasing is a globally significant credit instrument, but no ERC has defined how lease contracts should be queried on-chain. ERC-4907 covers only temporary usage rights for NFTs, not installments, interest, arrears, purchase options, or assignment. ERC-2615 adds lending and mortgage roles and security interests, but has no credit semantics such as schedules, index-linked units, arrears models, or purchase options. ERC-3475 standardizes only redemption-focused fungible debt instruments, not bilateral contracts with named parties, formal default, and asset collateral. Outside the EVM, ACTUS is a taxonomy for describing financial instruments as cash flow patterns, but it can only be read by adopting the entire taxonomy. Without a common interface, each issuer exposes its own custom contract, forcing integrators such as secondary markets, securitization vaults, auditors, and credit rating agencies to write separate custom adapters per issuer and country.
What to implement
function jurisdiction(uint256 leaseId) external view returns (bytes2);: Returns the legal jurisdiction applicable to the lease as a country code (bytes2).function governingLaw(uint256 leaseId) external view returns (string memory);: Returns the governing law applicable to the lease as a string.function agreementHash(uint256 leaseId) external view returns (bytes32);: Returns a hash pointing to the original off-chain contract document.function assetReference(uint256 leaseId) external view returns (string memory);: Returns a string reference identifying the leased asset.function lessor(uint256 leaseId) external view returns (address);: Returns the current lessor (creditor) address. Must match the ERC-721 token holder.function lessee(uint256 leaseId) external view returns (address);: Returns the current lessee address.function paymentAsset(uint256 leaseId) external view returns (address);: Returns the address of the ERC-20 settlement asset used for payments.function denomination(uint256 leaseId) external view returns (string memory symbol, address oracle);: Returns the unit-of-account symbol in which the schedule is denominated, and the oracle address used for conversion.function convertToAssets(uint256 leaseId, uint256 units) external view returns (uint256 assets);: Converts a given unit-of-account amount into a settlement asset amount.function convertToUnits(uint256 leaseId, uint256 assets) external view returns (uint256 units);: Converts a given settlement asset amount into a unit-of-account amount.function conversionRateAsOf(uint256 leaseId) external view returns (uint256 rate, uint64 asOf);: Returns the currently applicable conversion rate and its reference timestamp.function paymentCount(uint256 leaseId) external view returns (uint256);: Returns the number of installments included in the lease schedule.function paymentAt(uint256 leaseId, uint256 index) external view returns (uint256 units, uint64 dueDate, bool paid);: Returns the unit-of-account amount, due date, and payment status for a specific installment.function outstandingUnits(uint256 leaseId) external view returns (uint256);: Returns the remaining debt in units of account.function outstandingBalance(uint256 leaseId) external view returns (uint256);: Returns the remaining debt converted into settlement asset amount.function nextPayment(uint256 leaseId) external view returns (uint256 assets, uint64 dueDate);: Returns the next due settlement asset amount and its due date.function arrears(uint256 leaseId) external view returns (uint256);: Returns the arrears/penalty amount accrued to date.function status(uint256 leaseId) external view returns (LeaseStatus);: Returns the current status of the lease (Active, InArrears, etc.).function inputFreshness(uint256 leaseId, bytes32 input) external view returns (uint64 observedAt, uint64 reportedAt, uint64 maxStaleness);: Returns the time at which a specified input item was observed, the time it was recorded on-chain, and the tolerance margin.function pay(uint256 leaseId, uint256 assets) external;: Pays the lease installment using the settlement asset.function purchaseOption(uint256 leaseId) external view returns (uint256 priceInAssets, bool exercisable);: Returns the purchase option exercise price and whether it can be exercised now.function exercisePurchaseOption(uint256 leaseId) external;: Exercises the purchase option.event LeaseCreated(uint256 indexed leaseId, address indexed lessor, address indexed lessee, bytes2 jurisdiction, address paymentAsset);: Signals that a lease has been created, recording the lessor, lessee, jurisdiction, and settlement asset.event PaymentReceived(uint256 indexed leaseId, address indexed payer, uint256 assets, uint256 unitsSettled, uint256 conversionRate, uint256 newOutstandingUnits);: Signals that a payment has been received, recording the payment amount, units deducted, applied conversion rate, and remaining units.event ArrearsAccrued(uint256 indexed leaseId, uint256 totalArrearsUnits);: Signals that a payment deadline has passed and arrears have occurred.event DefaultDeclared(uint256 indexed leaseId, address indexed declarer);: Signals that an authorized party has declared default.event DefaultCured(uint256 indexed leaseId);: Signals that a default status has been cured.event PurchaseOptionExercised(uint256 indexed leaseId, uint256 priceInAssets);: Signals that the purchase option has been exercised, recording the exercise price.event LeaseTerminated(uint256 indexed leaseId, LeaseStatus finalStatus);: Signals that the lease has ended, recording the final status.event LesseeAssigned(uint256 indexed leaseId, address indexed oldLessee, address indexed newLessee);: Signals that the lessee has been reassigned.event TerminationRecorded(uint256 indexed leaseId, bytes32 indexed reason);: Records the reason for termination.event ServicingUpdated(uint256 indexed leaseId, bytes32 indexed input, uint64 observedAt, uint64 reportedAt);: Signals that off-chain servicing input has been updated.function canSettleAsset(uint256 leaseId, address to) external view returns (bool);: Returns whether the collateral asset can be settled to a specified address now.event AssetEscrowed(uint256 indexed leaseId, address token, uint256 tokenId);: Signals that the collateral asset has entered escrow.event AssetSettled(uint256 indexed leaseId, address indexed to);: Signals that the collateral asset has been settled and delivered.event AssetReleased(uint256 indexed leaseId, address indexed to);: Signals that the collateral asset has been returned.
In depth
Legal layer and parties
jurisdiction returns the applicable jurisdiction for the lease as a country code, and governingLaw returns the governing law as a string. agreementHash is a hash pointing to the off-chain contract, and assetReference is a string identifying the leased asset. lessor and lessee return the lessor's and lessee's addresses respectively, and the lessor must match the holder of the ERC-721 token whose tokenId equals the leaseId. agreementHash links on-chain state to the off-chain contract, but whether the token carries legal effect as ownership or a claim depends on each jurisdiction's legal framework.
Unit of account and conversion rules
The schedule is denominated in units of account and converted into a settlement asset (ERC-20). denomination returns the unit symbol and the oracle address; for fixed-amount leases, the oracle must be address(0) and both conversion functions must be identity functions. The conversion rate in conversionRateAsOf represents the number of settlement asset base units per 1e18 units of account. Rounding must not be biased in the caller's favor: convertToAssets, used to calculate the amount owed, must round up, while convertToUnits, used to reflect payments, must round down.
Two-stage model of arrears and default
InArrears is the objective fact that a payment deadline has passed unpaid, while InDefault is a legal act that must be explicitly declared by an authorized declarer, emitting DefaultDeclared. Default is curable: once arrears are cleared, the lease returns to a non-arrears status and DefaultCured is emitted. Completed, PurchaseExercised, and Terminated are terminal statuses, and terminal statuses cannot transition among each other except for the Completed to PurchaseExercised transition.
Arrears/penalty calculation as a function of elapsed time only
The amount returned by arrears() must be a function only of the payment schedule, the recorded payment history, and the time elapsed since each installment's deadline, and must not depend on the number or frequency of state-changing calls. Query functions must reflect state accrued as of the current block.timestamp, not as of the last time state was stored. Given the same schedule, payment history, and elapsed time, the arrears amount must be identical regardless of how many calls occurred in between. Penalty accrual must be measured from each installment's own specific deadline, and must not grant an implicit grace period starting from when the arrears were first observed on-chain.
Early termination
Termination reasons are distinguished by namespaced identifiers (TERMINATION_MUTUAL_AGREEMENT, TERMINATION_DEFAULT). Mutual termination requires active consent from both the lessee and the holder of lessor status (via a propose/accept procedure, etc.) and can be initiated from any non-terminal status. Termination due to default requires the lease to be in InDefault status, and is only possible after a configurable delay greater than zero has passed since the declaration. On termination, LeaseTerminated and TerminationRecorded must both be emitted, and economic figures such as balance, arrears, and penalties must not change after termination. The settlement method for remaining debt after early termination is out of scope for this standard.
Input freshness tracking
inputFreshness(leaseId, input) returns, for each input, the time it was observed off-chain (observedAt), the time it was recorded on-chain (reportedAt), and the declared tolerance (maxStaleness). The default input identifiers are INPUT_INDEX_OBSERVATION, INPUT_COLLECTIONS, INPUT_ARREARS_RECORD, INPUT_INSURANCE_STATUS, INPUT_ASSET_CONDITION, and INPUT_RESIDUAL_APPRAISAL. An input that has never been reported must return zero values rather than reverting. Only INPUT_INDEX_OBSERVATION feeds into values derived from conversionRateAsOf, and it is the only input that can revert a state-changing call. The rest are off-chain evidence uploaded by an authorized servicer that emit ServicingUpdated but do not affect balance or state calculations.
Payment-path liveness and the cure period
For index-linked leases, if the index observation is too old, calls requiring conversion such as pay() or exercisePurchaseOption() can fail. In this situation, even though the lessee cannot make payments, default-related actions (declaring default, termination for default, return of the collateral asset, etc.) must not proceed unless the index has remained non-stale for a cure period of G seconds (0 < G < maxStaleness). This determination must be based on the oracle's own on-chain verifiable record, not a timestamp supplied by the caller. Arrears and penalties continue to accrue during the cure period.
Optional extensions and Draft status
IFinancialLeaseAnchored links a lease to an asset registered in the ERC-8325 registry, and the chainId, registry address, and anchor identifier tuple must be either all zero or all populated. IFinancialLeaseAssetBound requires the collateral asset to be held in escrow while the lease is Active, InArrears, or InDefault; when the purchase option is exercised and canSettleAsset is true, settlement must occur simultaneously with payment; and return of the asset due to default is not automatically triggered merely by the InDefault state, but requires an explicit call from an authorized party. This EIP is still in Draft status, so its content may change or discussion may stall.
Things to watch out for
- Oracle manipulation and freshness: The conversion oracle for index-linked leases is the largest attack surface. Implementations must document the oracle source, update cadence, and freshness policy, and it is recommended that state-changing functions revert when the data is stale.
- Risk when the payment path is blocked: If the index observation goes stale, the settlement asset is paused, or the settlement asset's issuer blocks the recipient, pay() cannot succeed even as arrears keep accruing. While the settlement asset is paused, no settlement design allows the lessee to pay, leaving this as a residual risk.
- When an index never recovers: The procedure and authority for switching to a replacement index must be documented. If a feed is deprecated or its freshness can no longer be verified, default-related actions remain blocked indefinitely, leaving mutual termination as the only exit.
- Mixing penalties with principal: Penalties must be tracked separately from principal. If accrued penalties are mixed with the principal balance in a single accumulator, penalty payments risk being misapplied to principal.
- Role conflation: Authority to declare default, perform servicing, or hold the lessor position must not automatically grant authority to reassign the lessee. Otherwise the role holder faces a conflict of interest by benefiting from reassignment.