Skip to main content

primaryTerminalOf

The primary terminal that is managing funds for a project for a specified token.

Contracts should send tokens of the specified type to a project's primary terminal.

The zero address is returned if a terminal isn't found for the specified token.

Definition​

function primaryTerminalOf(uint256 _projectId, address _token)
  external
  view
  override
  returns (IJBPaymentTerminal) { ... }
  • Arguments:
    • _projectId is the ID of the project to get a terminal for.
    • _token is the token the terminal accepts.
  • The view function can be accessed externally by anyone.
  • The view function does not alter state on the blockchain.
  • The function overrides a function definition from the IJBDirectory interface.
  • The function returns the primary terminal for the project for the specified token.

Body​

  1. Check to see if the project has explicitly set a primary terminal for this token. If so, return it.

    // If a primary terminal for the token was specifically set and its one of the project's terminals, return it.
    if (
      _primaryTerminalOf[_projectId][_token] != IJBPaymentTerminal(address(0)) &&
      isTerminalOf(_projectId, _primaryTerminalOf[_projectId][_token])
    ) return _primaryTerminalOf[_projectId][_token];

    Internal references:

  2. Loop through each of the project's terminals looking for one that uses the same token as the one specified. If one is found, return it.

    // Return the first terminal which accepts the specified token.
    for (uint256 _i; _i < _terminalsOf[_projectId].length; _i++) {
      IJBPaymentTerminal _terminal = _terminalsOf[_projectId][_i];
      if (_terminal.acceptsToken(_token, _projectId)) return _terminal;
    }

    Internal references:

    External references:

  3. Return an empty terminal if not found.

    // Not found.
    return IJBPaymentTerminal(address(0));