Neverland Lending Core

Core Solidity contracts and generated TypeScript bindings for the Neverland lending protocol.

This repository starts from @aave/core-v3 version 1.19.3 and is maintained by Neverland as the canonical core-contract package for downstream Neverland lending deployments and integrations. Upstream Aave licensing, attribution, and notices are preserved where they apply.

Package

The package is prepared for publication as:

npm install @neverland-money/lending-core

The published package includes:

• contracts/: Solidity sources.
• artifacts/: Hardhat artifacts with ABI and bytecode.
• types/: TypeChain bindings.
• dist/: compiled helper exports.

Example Solidity import:

import { IPool } from '@neverland-money/lending-core/contracts/interfaces/IPool.sol';

contract Example {
  function supply(address pool, address token, address user, uint256 amount) external {
    IPool(pool).supply(token, amount, user, 0);
  }
}

Example artifact import:

const PoolArtifact = require('@neverland-money/lending-core/artifacts/contracts/protocol/pool/Pool.sol/Pool.json');

console.log(PoolArtifact.abi);

Neverland Changes

The initial Neverland setup keeps the Aave V3 core architecture intact while adding Neverland token price-observation behavior directly to the canonical token implementations:

• AToken emits PriceObserved on supply, transfer, withdraw, and liquidation-transfer paths.
• VariableDebtToken emits PriceObserved on variable borrow and repay paths.
• PriceEmitter centralizes the event and oracle-read helper.
• Token implementation revisions are bumped so upgrades can distinguish the Neverland implementations from the upstream base.

Neverland-specific tests live under test-suites/neverland/.

Development

Use Node 22.18.0 via .nvmrc.

nvm use
npm install
npm run compile
npm run build
npm test

Useful focused commands:

npm run compile:clean
npx hardhat test test-suites/__setup.spec.ts test-suites/neverland/price-emitter.spec.ts
npm run prettier:check

Layout

• contracts/protocol/: core protocol contracts and token implementations.
• contracts/interfaces/: public protocol interfaces.
• contracts/mocks/: test and upgradeability mocks.
• helpers/: TypeScript helpers used by tests and scripts.
• test-suites/: upstream Aave V3 tests plus Neverland-specific tests.
• artifacts/, types/, dist/: generated package outputs.

Upstream Provenance

This package is derived from:

• Package: @aave/core-v3
• Version: 1.19.3
• Repository: aave/aave-v3-core

For the original upstream README retained from the base package, see README_UPSTREAM.md.

License And Notices

See LICENSE.md. Solidity sources retain their original SPDX headers where applicable. This repository preserves upstream Aave licensing and attribution while documenting Neverland-maintained changes in package metadata and source history.