ip: use explicit types in api