Simple Proposal

1. Summary

PWNSimpleLoanSimpleProposal.sol defines the Simple Proposal type for Simple Loan and implements functions to make an on-chain proposal and accept proposals.

The Simple Proposal defines a single specific collateral loan. Interest can be either accruing or fixed.

3. Contract details

  • PWNSimpleLoanSimpleProposal.sol is written in Solidity version 0.8.16

Features

  • Provides acceptProposal function and makeProposal for on-chain proposals

  • Defines the Proposal struct

Inherited contracts, implemented Interfaces and ERCs

Functions

acceptProposal

Overview

A function to accept a proposal.

This function takes five arguments supplied by the caller:

  • addressacceptor - Address of a proposal acceptor

  • uint256refinancingLoanId - Refinancing loan ID

  • bytes32 calldataproposalData - Encoded proposal struct

  • bytes32[] calldataproposalInclusionProof - Multiproposal inclusion proof. Empty if single proposal

  • bytes calldatasignature - Signature of a proposal

Implementation

function acceptProposal(
    address acceptor,
    uint256 refinancingLoanId,
    bytes calldata proposalData,
    bytes32[] calldata proposalInclusionProof,
    bytes calldata signature
) override external returns (bytes32 proposalHash, PWNSimpleLoan.Terms memory loanTerms) {
    // Decode proposal data
    Proposal memory proposal = decodeProposalData(proposalData);

    // Make proposal hash
    proposalHash = _getProposalHash(PROPOSAL_TYPEHASH, abi.encode(proposal));

    // Try to accept proposal
    _acceptProposal(
        acceptor,
        refinancingLoanId,
        proposalHash,
        proposalInclusionProof,
        signature,
        ProposalBase({
            collateralAddress: proposal.collateralAddress,
            collateralId: proposal.collateralId,
            checkCollateralStateFingerprint: proposal.checkCollateralStateFingerprint,
            collateralStateFingerprint: proposal.collateralStateFingerprint,
            creditAmount: proposal.creditAmount,
            availableCreditLimit: proposal.availableCreditLimit,
            expiration: proposal.expiration,
            allowedAcceptor: proposal.allowedAcceptor,
            proposer: proposal.proposer,
            isOffer: proposal.isOffer,
            refinancingLoanId: proposal.refinancingLoanId,
            nonceSpace: proposal.nonceSpace,
            nonce: proposal.nonce,
            loanContract: proposal.loanContract
        })
    );

    // Create loan terms object
    loanTerms = PWNSimpleLoan.Terms({
        lender: proposal.isOffer ? proposal.proposer : acceptor,
        borrower: proposal.isOffer ? acceptor : proposal.proposer,
        duration: proposal.duration,
        collateral: MultiToken.Asset({
            category: proposal.collateralCategory,
            assetAddress: proposal.collateralAddress,
            id: proposal.collateralId,
            amount: proposal.collateralAmount
        }),
        credit: MultiToken.ERC20({
            assetAddress: proposal.creditAddress,
            amount: proposal.creditAmount
        }),
        fixedInterestAmount: proposal.fixedInterestAmount,
        accruingInterestAPR: proposal.accruingInterestAPR,
        lenderSpecHash: proposal.isOffer ? proposal.proposerSpecHash : bytes32(0),
        borrowerSpecHash: proposal.isOffer ? bytes32(0) : proposal.proposerSpecHash
    });
}
makeProposal

Overview

Function to create an on-chain proposal. Marks the hash of the supplied proposal as proposed.

This function takes one argument supplied by the caller:

  • Proposal calldataproposal - Proposal struct containing all needed proposal data

Implementation

function makeProposal(Proposal calldata proposal) external returns (bytes32 proposalHash) {
    proposalHash = getProposalHash(proposal);
    _makeProposal(proposalHash, proposal.proposer);
    emit ProposalMade(proposalHash, proposal.proposer, proposal);
}

View Functions

getProposalHash

Overview

This function returns supplied proposals hash according to EIP-712.

This function takes one argument supplied by the caller:

  • Proposal calldataproposal - Proposal struct to be hashed

Implementation

function getProposalHash(Proposal calldata proposal) public view returns (bytes32) {
    return _getProposalHash(PROPOSAL_TYPEHASH, abi.encode(proposal));
}
encodeProposalData

Overview

Function to encode a proposal struct.

This function takes one argument supplied by the caller:

  • Proposal memoryproposal - Proposal struct to be encoded

Implementation

function encodeProposalData(Proposal memory proposal) external pure returns (bytes memory) {
    return abi.encode(proposal);
}
decodeProposalData

Overview

Function to decode an encoded proposal struct.

This function takes one argument supplied by the caller:

  • bytes memoryproposalData - Encoded proposal data

Implementation

function decodeProposalData(bytes memory proposalData) public pure returns (Proposal memory) {
    return abi.decode(proposalData, (Proposal));
}

Events

The PWN Simple Loan Simple Proposal contract defines one event and no custom errors.

event ProposalMade(bytes32 indexed proposalHash, address indexed proposer, Proposal proposal);
ProposalMade

ProposalMade event is emitted when an on-chain proposal is made.

This event has three parameters:

  • bytes32 indexedproposalHash - Hash of the proposed proposal

  • address indexedproposer - Address of the proposer

  • Proposalproposal - The proposal made

Proposal struct

Type
Name
Comment

collateralCategory

Corresponding collateral category

address

collateralAddress

Address of a loan collateral

uint256

collateralId

ID of a collateral. Zero if ERC-20

uint256

collateralAmount

Amount of a collateral. Zero if ERC-721

bool

checkCollateralStateFingerprint

Flag to enable check of collaterals state fingerprint (see ERC-5646)

bytes32

collateralStateFingerprint

A collateral state fingerprint (see ERC-5646)

address

creditAddress

Address of credit asset

uint256

creditAmount

Amount of credit asset

uint256

availableCreditLimit

Maximum credit limit of credit asset

uint256

fixedInterestAmount

Fixed interest amount in credit tokens. It is the minimum amount of interest which has to be paid by a borrower

uint24

accruingInterestAPR

Accruing interest APR with 2 decimals

uint32

duration

Loan duration in seconds

uint40

expiration

Proposal expiration unix timestamp in seconds

address

allowedAcceptor

Allowed acceptor address. Zero address if propsal can be accepted by any account

address

proposer

Proposer address

bytes32

proposerSpecHash

Hash of a proposer specific data, which must be provided during a loan creation

bool

isOffer

Flag to determine if a proposal is an offer or loan request

uint256

refinancingLoanId

ID of a loan to be refinanced. Zero if creating a new loan.

uint256

nonceSpace

Nonce space of the proposal

uint256

nonce

Nonce of the proposal

address

loanContract

Loan type contract

Last updated