> For the complete documentation index, see [llms.txt](https://docs.notional.finance/developers/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.notional.finance/developers/smart-contract-documentation/erc1155trade.md). # ERC1155 Trade ## ERC1155Trade Implements the ERC1155 token standard for trading OTC and batch operations over Notional markets. ### Methods * [batchOperation(address account, uint32 maxTime, struct Common.Deposit\[\] deposits, struct Common.Trade\[\] trades)](#batchOperation) * [batchOperationWithdraw(address account, uint32 maxTime, struct Common.Deposit\[\] deposits, struct Common.Trade\[\] trades, struct Common.Withdraw\[\] withdraws)](#batchOperationWithdraw) * [safeTransferFrom(address from, address to, uint256 id, uint256 value, bytes data)](#safeTransferFrom) * [safeBatchTransferFrom(address, address, uint256\[\], uint256\[\], bytes)](#safeBatchTransferFrom) ### Events * [BatchOperation(address account, address operator)](#BatchOperation) ### Governance Methods * [setBridgeProxy(address bridgeProxy)](#setBridgeProxy) ## Methods #### batchOperation > Allows batch operations of deposits and trades. Approved operators are allowed to call this function on behalf of accounts. > > **Parameters:** > > * account: account for which the operation will take place > * maxTime: after this time the operation will fail > * deposits: a list of deposits into the Escrow contract, ERC20 allowance must be in place for the Escrow contract > > or these deposits will fail. > * trades: a list of trades to place on fCash markets **Error Codes:** * TRADE\_FAILED\_MAX\_TIME: the operation will fail due to the set timeout * UNAUTHORIZED\_CALLER: operator is not authorized for the account * INVALID\_CURRENCY: currency specified in deposits is invalid * MARKET\_INACTIVE: maturity is not a valid one * INSUFFICIENT\_BALANCE: insufficient cash balance (or token balance when removing liquidity) * INSUFFICIENT\_FREE\_COLLATERAL: account does not have enough free collateral to place the trade * OVER\_MAX\_FCASH: \[addLiquidity] fCash amount required exceeds supplied maxfCash * OUT\_OF\_IMPLIED\_RATE\_BOUNDS: \[addLiquidity] depositing collateral would require more fCash than specified * TRADE\_FAILED\_TOO\_LARGE: \[takeCurrentCash, takefCash] trade is larger than allowed by the governance settings * TRADE\_FAILED\_LACK\_OF\_LIQUIDITY: \[takeCurrentCash, takefCash] there is insufficient liquidity in this maturity to handle the trade * TRADE\_FAILED\_SLIPPAGE: \[takeCurrentCash, takefCash] trade is greater than the max implied rate set #### batchOperationWithdraw > Allows batch operations of deposits, trades and withdraws. Approved operators are allowed to call this function on behalf of accounts. > > **Parameters:** > > * account: account for which the operation will take place > * maxTime: after this time the operation will fail > * deposits: a list of deposits into the Escrow contract, ERC20 allowance must be in place for the Escrow contract > > or these deposits will fail. > * trades: a list of trades to place on fCash markets > * withdraws: a list of withdraws, if amount is set to zero will attempt to withdraw the account's entire balance > > of the specified currency. This is useful for borrowing when the exact exchange rate is not known ahead of time. **Error Codes:** * TRADE\_FAILED\_MAX\_TIME: the operation will fail due to the set timeout * UNAUTHORIZED\_CALLER: operator is not authorized for the account * INVALID\_CURRENCY: currency specified in deposits is invalid * MARKET\_INACTIVE: maturity is not a valid one * INSUFFICIENT\_BALANCE: insufficient cash balance (or token balance when removing liquidity) * INSUFFICIENT\_FREE\_COLLATERAL: account does not have enough free collateral to place the trade * OVER\_MAX\_FCASH: \[addLiquidity] fCash amount required exceeds supplied maxfCash * OUT\_OF\_IMPLIED\_RATE\_BOUNDS: \[addLiquidity] depositing collateral would require more fCash than specified * TRADE\_FAILED\_TOO\_LARGE: \[takeCurrentCash, takefCash] trade is larger than allowed by the governance settings * TRADE\_FAILED\_LACK\_OF\_LIQUIDITY: \[takeCurrentCash, takefCash] there is insufficient liquidity in this maturity to handle the trade * TRADE\_FAILED\_SLIPPAGE: \[takeCurrentCash, takefCash] trade is greater than the max implied rate set #### safeTransferFrom > Transfers tokens between from and to addresses. > > **Parameters:** > > * from: Source address > * to: Target address > * id: ID of the token type > * value: Transfer amount > * data: Additional data with no specified format, unused by this contract but forwarded unaltered > > to the ERC1155TokenReceiver. **Error Codes:** * UNAUTHORIZED\_CALLER: calling contract must be approved by both from / to addresses or be the 0x proxy * OVER\_MAX\_UINT128\_AMOUNT: amount specified cannot be greater than MAX\_UINT128 * INVALID\_SWAP: the asset id specified can only be of CASH\_PAYER or CASH\_RECEIVER types * INVALID\_CURRENCY: the currency id specified is invalid * INVALID\_CURRENCY: the currency id specified is invalid #### safeBatchTransferFrom > No description ## Events #### BatchOperation > Notice that a batch operation occured > > **Parameters:** > > * account: the account that was affected by the operation > * operator: the operator that sent the transaction ## Governance Methods #### setBridgeProxy > Sets the address of the 0x bridgeProxy that is allowed to mint fCash pairs. > > **Parameters:** > > * bridgeProxy: address of the 0x ERC1155AssetProxy --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.notional.finance/developers/smart-contract-documentation/erc1155trade.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.