feat: Batch IP Asset Registration with Optimized Workflows

[bonnie57]

Description

This PR introduces a new high-level batch registration method batch_ip_asset_with_optimized_workflows() that intelligently selects the appropriate workflow based on input parameters and provides automatic transaction batching for better gas efficiency.

Key Features

1. Intelligent Workflow Selection

The method automatically routes requests to the most appropriate workflow contract based on the combination of parameters provided:
For MintAndRegisterRequest (mint new NFT + register as IP):
license_terms_data + royalty_shares → mintAndRegisterIpAndAttachPILTermsAndDistributeRoyaltyTokens
license_terms_data only → mintAndRegisterIpAndAttachPILTerms
deriv_data + royalty_shares → mintAndRegisterIpAndMakeDerivativeAndDistributeRoyaltyTokens
deriv_data only → mintAndRegisterIpAndMakeDerivative

For RegisterRegistrationRequest (register existing NFT as IP):
license_terms_data + royalty_shares → registerIpAndAttachPILTermsAndDeployRoyaltyVault
deriv_data + royalty_shares → registerIpAndMakeDerivativeAndDeployRoyaltyVault
license_terms_data only → registerIpAndAttachPILTerms
deriv_data only → registerIpAndMakeDerivative

2. Smart Multicall Strategy

• Multicall3: Used when is_use_multicall=True for eligible MintAndRegisterRequest operations (when spg_nft_contract has public minting enabled except mintAndRegisterIpAndAttachPILTermsAndDistributeRoyaltyTokens)
• Workflow's native multicall: Used for all RegisterRegistrationRequest operations (due to signature requirements) and MintAndRegisterRequest with royalty shares (due to msg.sender limitations)
• Requests targeting the same workflow contract are automatically aggregated into a single transaction

3. Automatic Royalty Distribution

When royalty_shares are provided, the method automatically handles the two-step process:

• Register IP and deploy royalty vault
• Distribute royalty tokens (separate transaction, as it requires the vault address from step 1)

Code Example

# Mix different request types in a single batch
response = client.ip_asset.batch_ip_asset_with_optimized_workflows(
    requests=[
        # Mint new NFT and register with license terms
        MintAndRegisterRequest(
            spg_nft_contract="0x...",
            license_terms_data=[...],
            ip_metadata={...}
        ),
        # Register existing NFT as derivative
        RegisterRegistrationRequest(
            nft_contract="0x...",
            token_id=123,
            deriv_data={...},
            ip_metadata={...}
        ),
        # Mint and register with royalty shares
        MintAndRegisterRequest(
            spg_nft_contract="0x...",
            license_terms_data=[...],
            royalty_shares=[...],
        ),
    ],
    is_use_multicall=True
)